connect

Create or update a connector project connection

Changed on

Connect a connector to a project, or replace the environments on an existing project connection.

post/v1/connect/connectors/{connector}/projects/{projectId}

Request

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

Path parameters

connectorstring required

Stable connector ID or URL-encoded team-scoped UID. Examples: scl_abc123 or slack%2Fmy-bot.

projectIdstring required

Vercel project ID.

Query parameters

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The team ID that scopes the request. Do not send it with slug. If both are omitted, Vercel uses the team associated with the token or the authenticated user's default team. The request returns 401 if no team can be selected.

slugstring
Example:my-team-url-slug

The team slug that scopes the request. Do not send it with teamId. If both are omitted, Vercel uses the team associated with the token or the authenticated user's default team. The request returns 401 if no team can be selected.

Request body

Response

The connector project connection was created or updated.

connectorIdstring required

Stable scl_ connector ID, even when the request used a UID.

createdAtnumber required

Time when the project connection was created, in epoch milliseconds.

updatedAtnumber required

Time when the project connection was last updated, in epoch milliseconds.

Changes