---
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` union, required — A built-in environment name or the stable env_* ID of a custom environment.
      - 'development' | 'preview' | 'production'
      - string
    - `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
    - `data` object
    - `installationId` string
    - `audience` string[]
    - `scopes` string[]
    - `resources` string[]
    - `authorizationDetails` object[]
      - `type` string, required
    - `expiresAt` number, required
    - `expiresIn` number
    - `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
    - `subject` union, required
      - object
        - `type` 'app', required
      - object
        - `type` 'user', required
        - `id` string, required
        - `issuer` string
    - `environment` union, required
      - string
      - 'development' | 'preview' | 'production'
    - `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`

---

[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/b4d86a3e3479/schema)