POST
/
connect_sessions
Create Connect Session
curl --request POST \
  --url https://api.stackone.com/connect_sessions \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "categories": [
    "ats",
    "hris",
    "hrisLegacy",
    "crm",
    "iam",
    "marketing",
    "lms",
    "stackOne",
    "documents",
    "ticketing",
    "screening",
    "messaging",
    "accounting"
  ],
  "provider": "<string>",
  "provider_version": "<string>",
  "origin_owner_id": "<string>",
  "origin_owner_name": "<string>",
  "origin_username": "<string>",
  "account_id": "<string>",
  "expires_in": 1800,
  "metadata": {},
  "multiple": false,
  "label": "<string>",
  "type": [
    "PRODUCTION",
    "TEST"
  ]
}'
{
  "id": 123,
  "organization_id": 123,
  "project_id": "<string>",
  "categories": [
    "ats",
    "hris",
    "hrisLegacy",
    "crm",
    "iam",
    "marketing",
    "lms",
    "stackOne",
    "documents",
    "ticketing",
    "screening",
    "messaging",
    "accounting"
  ],
  "provider": "<string>",
  "origin_owner_id": "<string>",
  "origin_owner_name": "<string>",
  "origin_username": "<string>",
  "account_id": "<string>",
  "label": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "metadata": {},
  "external_trigger_token": "f0bc3d88-2178-5423-8c81-b81d6c9da824",
  "type": [
    "PRODUCTION",
    "TEST"
  ],
  "token": "<string>",
  "auth_link_url": "<string>"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
​
origin_owner_id
string
required

The origin owner identifier

​
origin_owner_name
string
required

The origin owner name

​
categories
enum<string>[] | null

The categories of the provider to connect to

Example:
[
  "ats",
  "hris",
  "hrisLegacy",
  "crm",
  "iam",
  "marketing",
  "lms",
  "stackOne",
  "documents",
  "ticketing",
  "screening",
  "messaging",
  "accounting"
]
​
provider
string | null

The provider to connect to

​
provider_version
string | null

The provider version to connect to

​
origin_username
string | null

The origin username

​
account_id
string | null

The unique identifier for the account associated with this connect session. When this field is present, the hub will launch in edit mode using the retrieved token.

​
expires_in
number | null
default:1800

How long the session should be valid for in seconds

​
metadata
object | null

The metadata for the connection

​
multiple
boolean | null
default:false

If set, this connect session will allow creation of multiple accounts with the same origin owner id and provider. Has no effect if account_id is set.

​
label
string | null

The label to be applied to the account associated with this connect session.

​
type
enum<string> | null
default:production

The connect session account type

Available options:
production,
test
Example:
["PRODUCTION", "TEST"]

Response

The details of the connect session created with token and auth link

​
id
number
required
​
organization_id
number
required
​
project_id
string
required
​
origin_owner_id
string
required
​
origin_owner_name
string
required
​
created_at
string<date-time>
required
​
token
string
required
​
auth_link_url
string
required
​
categories
enum<string>[] | null
Example:
[
  "ats",
  "hris",
  "hrisLegacy",
  "crm",
  "iam",
  "marketing",
  "lms",
  "stackOne",
  "documents",
  "ticketing",
  "screening",
  "messaging",
  "accounting"
]
​
provider
string | null
​
origin_username
string | null
​
account_id
string | null
​
label
string | null
​
metadata
object | null

Arbitrary set of key and values defined during the session token creation. This can be used to tag an account (eg. based on their pricing plan)

​
external_trigger_token
string | null

External trigger token to be used to trigger actions on the account

Example:

"f0bc3d88-2178-5423-8c81-b81d6c9da824"

​
type
enum<string> | null

The connect session account type

Available options:
production,
test,
unmapped_value
Example:
["PRODUCTION", "TEST"]