---
title: "Get a Connect token"
method: POST
path: "/v1/connect/token/{connector}"
tags: ["connect"]
---

# Get a Connect token

`POST /v1/connect/token/{connector}`

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

## Path parameters

- `connector` string, required

## Request body

- object
  - `subject` union
    - object
      - `type` 'app', required
    - object
      - `type` 'user', required
      - `id` string
      - `issuer` string
    - object
      - `type` 'jwt-bearer', required
      - `sub` string
      - `iss` string
      - `aud` string
      - `additionalClaims` object
    - object
      - `type` 'token', required
      - `token` string, required
  - `installationId` string
  - `audience` string[]
  - `scopes` string[]
  - `resources` string[]
  - `authorizationDetails` object[]
    - `type` string
  - `validityBufferMs` number

## Response `200`

- object
  - `token` string, required
  - `tokenId` string, required
  - `expiresAt` number, required
  - `connector` object, required
    - `id` string, required
    - `uid` string, required
    - `type` string, required
  - `name` string
  - `installationId` string
  - `tenantId` string
  - `externalSubject` string
  - `authorizationId` string — Stable id correlating all tokens (including refreshes) back to the original authorization.
  - `tokenGroupId` string — Stable id that groups all tokens with the same parameters across refreshes.
  - `claims` object — Claims extracted from the provider's tokens per the connector's `ForwardedClaims` allow-list. Currently sourced from the OIDC id_token only.
  - `metadata` object — Driver-specific metadata (e.g., botUserId for Slack).

## Other responses

- `400` — One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `410`
- `422`
- `429`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)