Skip to main content
POST
/
sessions
Create a connection session
curl --request POST \
  --url https://api.bundleup.io/v1/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "integrationId": "<string>",
  "externalId": "<string>",
  "metadata": {},
  "redirectUri": "<string>"
}
'
{
  "expires_in": 123,
  "token": "<string>",
  "auth_url": "<string>",
  "external_id": "<string>"
}

Authorizations

Authorization
string
header
required

API Key authentication using Bearer token

Body

application/json
integrationId
string
required

Integration identifier to create session for

externalId
string

External ID for the connection

metadata
object

Optional metadata for the session

redirectUri
string<uri>

Optional redirect URI after authorization

Response

Session created successfully

expires_in
integer
required

Session expiration time in seconds

token
string
required

Session token

auth_url
string<uri>
required

Authorization URL to redirect user to

external_id
string

External ID if provided