---
title: "Import Connect tokens"
method: POST
path: "/v1/connect/token/{connector}/import"
tags: ["connect"]
---

# Import Connect tokens

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

Import access and refresh tokens for a connector identified by the path parameter.

## Path parameters

- `connector` string, required

## Request body

- object
  - `tokens` object[], required
    - `accessToken` string, required
    - `expiresAt` number, required
    - `refreshToken` string
    - `refreshTokenExpiresAt` number
    - `subject` union, required
      - object
        - `type` 'app', required
      - object
        - `type` 'user', required
        - `id` string, required
        - `issuer` string
    - `environment` 'development' | 'preview' | 'production', required
    - `installationId` string
    - `audience` string[]
    - `scopes` string[]
    - `resources` string[]
    - `authorizationDetails` object[]
      - `type` string
    - `name` string
    - `externalSubject` string
    - `installation` object
      - `id` string, required
      - `name` string
    - `tenant` object
      - `id` string, required
      - `name` string
    - `data` object

## Response `200`

- object
  - `accepted` number, required
  - `imported` number, required
  - `tokens` object[], required
    - `name` string
    - `installationId` string
    - `audience` string[]
    - `scopes` string[]
    - `resources` string[]
    - `authorizationDetails` object[]
      - `type` string, required
    - `expiresAt` number, required
    - `refreshTokenExpiresAt` number
    - `externalSubject` string
    - `claims` object — Claims extracted from the provider's tokens per the connector's `ForwardedClaims` allow-list. Currently sourced from the OIDC id_token only.
    - `installation` object
      - `id` string, required
      - `name` string
    - `tenant` object
      - `id` string, required
      - `name` string
    - `data` object
    - `subject` union, required
      - object
        - `type` 'app', required
      - object
        - `type` 'user', required
        - `id` string, required
        - `issuer` string
    - `environment` 'development' | 'preview' | 'production', required
    - `succeeded` false | true, required

## 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`

## Changes

- **2026-07-21** `2ae10ee9d21c` — 3 info
  - added the non-success response with the status `410`
  - removed the non-success response with the status `504`
  - added the optional property `tokens/items/claims` to the response with the `200` status
- **2026-07-08** `3ff660568354` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/vercel/apis/api/changes/v1/connect/token/:connector/import/post.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) · [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/api/revisions/dc85585fad8d/schema)