---
title: "POST /partner-sdk/token/bot"
method: POST
path: "/partner-sdk/token/bot"
---

# POST /partner-sdk/token/bot

`POST /partner-sdk/token/bot`

## Request body

- object
  - `provisional_user_id` string, snowflake
  - `external_user_id` string, required
  - `preferred_global_name` string, nullable

## Response `200`

200 response for bot_partner_sdk_token

- ProvisionalTokenResponse
  - `token_type` string, required
  - `access_token` string, required
  - `expires_in` integer, required
  - `scope` string, required
  - `id_token` string, required
  - `refresh_token` string, nullable
  - `scopes` string[], nullable
  - `expires_at_s` integer, nullable

## Other responses

- `429` — Client ratelimited response
- `4XX` — Client error response

## Changes

- **2026-05-23** `b5b13e5b3535` — 1 info
  - added the new optional request property `provisional_user_id`
- **2026-03-30** `890925a1ead3` — 1 breaking
  - the `external_user_id` request property's minLength was increased from `0` to `1`

[Change history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/partner-sdk/token/bot/post.md)

---

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