Actions30
- Attachment Actions
- Chat Actions
- Chat Message Actions
- Phone Number Actions
- Webhook Subscription Actions
Webhook Subscription → Create
AI-generatedSummary
Creates a webhook subscription for specified events and optionally filters by phone numbers
Inputs
- webhookUrl (required) — The URL that will receive POST requests when the selected events occur.
- events (required) — Comma-separated list of event names to subscribe to (e.g., "message_created,message_updated").
- webhookPhoneNumbers — Optional comma-separated list of phone numbers to filter which deliveries trigger the webhook.
Output shape
a created webhook subscription object
Returns the full subscription record including its ID, target_url, subscribed_events, phone_numbers, active status, etc.; validation errors are raised before a response is returned.
Examples
Example 1: Create a webhook for message_created events
webhookUrl: https://example.com/webhook, events: message_created
Example 2: Create a filtered webhook with phone numbers
webhookUrl: https://example.com/webhook, events: message_created, webhookPhoneNumbers: +15551234567,+15557654321