---
title: "Create an Admin Portal Link Token"
method: POST
path: "/admin_portal_link_tokens"
tags: ["Admin Portal Link Tokens"]
---

# Create an Admin Portal Link Token

`POST /admin_portal_link_tokens`

## Request body

- object
  - `organization_id` string
  - `it_contact_id` string
  - `scopes` string[]
  - `seconds_until_expiration` integer

## Response `201`

201 Created

- object
  - `object` 'admin_portal_link_token', required
  - `id` string, required
  - `admin_portal_link_id` string, required — The origin-level admin_portal_link this token was issued for.
  - `instance_id` string, required
  - `organization_id` string, nullable, required — Optional. Present only when the link is scoped to an existing org.
  - `it_contact_id` string, nullable, required — Optional opaque reference to the IT contact associated with this link.
  - `scopes` string[], nullable, required — Caller-provided scopes for this token.
  - `token` string, required — The single-use admin portal link token. Returned only on creation. URL-borne; treat as a secret.
  - `revoked` boolean, required
  - `revocation_reason` string, nullable, required
  - `expired` boolean, required
  - `expiration` number, nullable, required — The timestamp for when the token will expire, in milliseconds.
  - `created_at` number, required — The timestamp for when the token was created, in milliseconds.
  - `updated_at` number, required — The timestamp for when the token was last updated, in milliseconds.

## Other responses

- `400` — 400 Bad Request
- `401` — 401 Unauthorized
- `403` — 403 Forbidden
- `409` — 409 Conflict

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/cf036e7951d3/schema)