Sign in

v13

latestOpenAPI 3.0.32026-07-31359869.4 MB
connect

Get a Connect token

Get an access token for a connector identified by the path parameter and scoped to the requester.

post/v1/connect/token/{connector}

Path parameters

connectorstring required

Request body

installationIdstring
audiencestring[]
scopesstring[]
resourcesstring[]
validityBufferMsnumber

Response

tokenstring required
tokenIdstring required
expiresAtnumber required
namestring
installationIdstring
tenantIdstring
externalSubjectstring
authorizationIdstring

Stable id correlating all tokens (including refreshes) back to the original authorization.

tokenGroupIdstring

Stable id that groups all tokens with the same parameters across refreshes.

claimsobject

Claims extracted from the provider's tokens per the connector's ForwardedClaims allow-list. Currently sourced from the OIDC id_token only.

metadataobject

Driver-specific metadata (e.g., botUserId for Slack).