Sign in
latestOpenAPI 3.0.2MIT2026-08-1745267541.8 KB

bdb3e0c48bf7

Webhooks

Update an existing webhook

Updates an existing webhook as specified by the webhook ID.

patch/v1/projects/{project_id}/webhooks/{webhook_id}

Query parameters

update_maskstring[]

The set of field mask paths.

Request body

app_idstring

The app that this webhook belongs to.

idstring

The ID of the webhook.

secretstring password

Optional secret be used to sign contents of webhooks sent by the Conversation API. You can then use the secret to verify the signature.

targetstring required

The target url where events should be sent to. Maximum URL length is 742. The conversation-api.*.sinch.com subdomains are forbidden.

target_type'DISMISS' | 'HTTP'
triggersWebhookTrigger[]

An array of triggers that should trigger the webhook and result in an event being sent to the target url. Refer to the list of Webhook Triggers for a complete list.

Example request

{
  "triggers": [
    "MESSAGE_DELIVERY"
  ]
}

Response

A successful response.

app_idstring

The app that this webhook belongs to.

idstring

The ID of the webhook.

secretstring password

Optional secret be used to sign contents of webhooks sent by the Conversation API. You can then use the secret to verify the signature.

targetstring required

The target url where events should be sent to. Maximum URL length is 742. The conversation-api.*.sinch.com subdomains are forbidden.

target_type'DISMISS' | 'HTTP'
triggersWebhookTrigger[]

An array of triggers that should trigger the webhook and result in an event being sent to the target url. Refer to the list of Webhook Triggers for a complete list.

Example response

{
  "triggers": [
    "MESSAGE_DELIVERY"
  ]
}