API ReferenceIntegrations

Configure a chat integration webhook

Registers the Notifly webhook URL with the chat provider for the specified integration. Telegram is the only supported provider initially.

Registers the Notifly webhook URL with the chat provider for the specified integration. Telegram is the only supported provider initially.

Authorization

secretKey

Authorization<token>

API key authentication. Allowed headers-- "Authorization: ApiKey <secret_key>".

In: header

Path Parameters

integrationIdentifier*string

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

curl -X POST "https://example.com/v1/integrations/string/webhook/configure"

{  "data": {    "webhookUrl": "string",    "configuredAt": "string",    "botUsername": "string"  }}

Issue a URL to link a subscriber chat identity POST

Returns a provider-specific URL the subscriber opens to link their chat identity. The integration provider is resolved from integrationIdentifier; Telegram returns a deep link.

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

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