Open a private chat by Telegram username

Requires a send-scoped key, the Start Chat feature gate, and Idempotency-Key. Accepts only usernames and supported t.me username links. Resolves and opens the chat without sending a message; no Unipile or legacy provider fallback.

post/chats/start

Request

  • Base URL: https://gramclaw.com/api/v1
  • URL: https://gramclaw.com/api/v1/chats/start
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Stable caller-generated identity for this exact mutation. Ambiguous operations are not retried.

Request body

account_idstring required
identifierstring required

Telegram username, @username, or supported t.me username link.

Response

Exact account-scoped private chat, or replay of the completed operation

Changes

No recorded changes to this operation across all 1 revision of this API.