VEvercel
connect

Get a Connect token

Changed on

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

post/v1/connect/token/{connector}

Request

  • Base URL
    https://api.vercel.com
  • URL
    https://api.vercel.com/v1/connect/token/{connector}
  • Auth
    HTTP bearer

Path parameters

connectorstring required

Request body

installationIdstring
audiencestring[]
scopesstring[]
resourcesstring[]
validityBufferMsnumber

Response

authorizationIdstring

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

claimsobject

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

expiresAtnumber required
externalSubjectstring
installationIdstring
metadataobject

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

namestring
tenantIdstring
tokenstring required
tokenGroupIdstring

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

tokenIdstring required

Changes