---
title: "`POST /orgs/{org_id}/connectors/enrollment-tokens`"
method: POST
path: "/orgs/{org_id}/connectors/enrollment-tokens"
tags: ["connectors"]
---

# \`POST /orgs/{org_id}/connectors/enrollment-tokens\`

`POST /orgs/{org_id}/connectors/enrollment-tokens`

## Request

- Base URL: `https://api.timbal.ai`
- URL: `https://api.timbal.ai/orgs/{org_id}/connectors/enrollment-tokens`
- Auth: HTTP bearer

Create a connector enrollment token.

## Path parameters

- `org_id` string, required

## Request body

- ReqBody
  - `name` string, nullable: Operator label ("warehouse-pg box").
  - `ttl_secs` integer, nullable: Token lifetime in seconds. Default 86400 (24h), max 30 days.

## Response `201`

Token minted (raw value shown once)

- ResBody
  - `expires_at` string, date-time, required
  - `token` string, required: Raw enrollment token, shown once in the response.
  - `token_id` string, required

## Other responses

- `400`: Invalid TTL
- `403`: Forbidden

## Changes

- **2026-07-03** `e1c81d0f4235`: 1 info
  - endpoint added
- **2026-03-16** `eb2c08128881`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/changes/orgs/:org_id/connectors/enrollment-tokens/post.md)

---

[API](https://skmtc.dev/timbal-ai/apis/timbal-platform-api.md) - [All operations](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/revisions/dd7e398ce0d3?raw)