v5

latestOpenAPI 3.0.0MIT2026-08-041554551.6 MB

Integrations

Issue a short-lived mobile setup link for an existing integration

Returns an opaque, single-use setup token plus a mobile URL for configuring an existing chat integration. Telegram is the only supported provider initially.

post/v1/integrations/{integrationIdentifier}/mobile-link

Path parameters

integrationIdentifierstring required

Request body

subscriberIdstring

Optional subscriber to link via /start deep link after mobile setup completes. When provided, the consume response may include a ready-to-open Telegram deep link.

Example request

{
  "subscriberId": "subscriber-123"
}

Response

tokenstring required

Opaque, single-use token identifying this Telegram mobile-setup session

urlstring required

Absolute URL the user can open on a mobile device to complete Telegram setup

expiresAtstring required

ISO-8601 timestamp at which the token expires