Skip to main content
PUT
Update a webhook subscription

Authorizations

Authorization
string
header
required

Bearer token authentication. Include your API token in the Authorization header.

Format: Authorization: Bearer <your-token>

Path Parameters

subscriptionId
string
required

Unique identifier of the webhook subscription

Body

application/json
target_url
string<uri>

New target URL for webhook events

subscribed_events
enum<string>[]

Updated list of event types to subscribe to

Minimum array length: 1
Available options:
message.sent,
message.received,
message.read,
message.delivered,
reaction.added,
reaction.removed,
participant.added,
participant.removed,
chat.created,
chat.group_name_updated,
chat.group_icon_updated,
chat.typing_indicator.started,
chat.typing_indicator.stopped
is_active
boolean

Activate or deactivate the subscription

Response

Webhook subscription updated successfully

id
string
required

Unique identifier for the webhook subscription

target_url
string<uri>
required

URL where webhook events will be sent

subscribed_events
enum<string>[]
required

List of event types this subscription receives

Available options:
message.sent,
message.received,
message.read,
message.delivered,
reaction.added,
reaction.removed,
participant.added,
participant.removed,
chat.created,
chat.group_name_updated,
chat.group_icon_updated,
chat.typing_indicator.started,
chat.typing_indicator.stopped
is_active
boolean
required

Whether this subscription is currently active

created_at
string<date-time>
required

When the subscription was created

updated_at
string<date-time>
required

When the subscription was last updated