← API Reference
Provider Guide

TikTok authorization

TikTok uses the standard QR authorization endpoints. QR material may arrive asynchronously; this guide documents source-level adapter behavior, not a guarantee that every real account can complete the flow.

qrcode

TikTok QR authorization uses the standard account and QR endpoints; the first start response may not contain a QR URL.

  1. 1. POST /v1/accounts with provider=tiktok and auth_mode=qrcode.
  2. 2. POST /v1/accounts/{account_id}/auth/qr/start to start the TikTok browser session.
  3. 3. Listen for account.auth.required or poll POST /v1/accounts/{account_id}/auth/qr/check until QR material or the authorization result is available.
  4. 4. After account.auth.succeeded, confirm runtime_status and start the runtime only if it is not already running.

Notes

  • The initial qr/start response may omit the QR URL. Keep the webhook registered and use qr/check as the polling fallback.
  • Current source mapping emits message.received only for private conversations. Group, acknowledgement, notice, and comment events are not public standard events, and source support is not a real-account E2E guarantee.