v29

latestOpenAPI 3.1.2raw.githubusercontent.com2026-08-014117755.2 KB

Webhooks

Create Webhook

Creates a new webhook that listens for specific events. Supports optional association with a chat.

post/hooks

namestring required

A human-readable name for the webhook.

eventsstring[] required

List of event types the webhook should subscribe to.

urlstring uri required

The target URL to receive the webhook payloads.

chatIdstring nullable required

The ID of a chat to scope the webhook to.

Response for status 200

idstring required

A unique identifier for the webhook.

createdAtstring date-time required

The ISO timestamp representing when the chat was created.

namestring required

A user-defined name to label the webhook.

eventsstring[] required

List of event types this webhook is subscribed to.

urlstring required

Target URL that receives event payloads for this webhook.

chatIdstring nullable required

Optional ID of the chat that this webhook is scoped to.