---
title: "Create chat ID discovery token"
method: POST
path: "/api/v1/hitl/chat-id-discovery"
tags: ["HITL"]
---

# Create chat ID discovery token

`POST /api/v1/hitl/chat-id-discovery`

## Request

- Base URL: `https://api.proof.holdings`
- URL: `https://api.proof.holdings/api/v1/hitl/chat-id-discovery`
- Auth: HTTP bearer

Generate a Telegram deeplink for auto-detecting a user's chat ID. The user clicks the link, messages the bot, and the chat ID is captured.

## Response `201`

Discovery token created

- ChatIdDiscoveryResponse: Chat ID discovery token and Telegram deeplink
  - `token` string, required
  - `deep_link` string, uri, required
  - `qr_code` string, required: QR code data URL for the deep link
  - `qr_text` string, required: UTF-8 text representation of the QR code for terminal/agent display
  - `expires_in` integer, required

---

[API](https://skmtc.dev/proof/apis/proof-holdings-api.md) · [All operations](https://skmtc.dev/proof/apis/proof-holdings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proof/apis/proof-holdings-api/revisions/b15f506de696?raw)