NOnovu
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

Request

  • Base URL
    https://api.novu.co
  • Auth
    API key in header Authorization

Path parameters

integrationIdentifierstring required

Headers

idempotency-keystring

A header for idempotency purposes

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

OK

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

Changes

No recorded changes to this operation across all 20 revisions of this API.