Edit Webhooks

Replaces the settings, events and WhatsApp numbers of an existing webhook.

Before you call

  • The API key's user needs permission to add webhooks.
  • Get webhookId from Get Webhooks.
  • Send the full webhook, as in Register New Webhook: name, url, method, webhookEvents and wabaNumbers are required.
  • All wabaNumbers must be channels of the same type.

How it works

  • The events and numbers you send replace the previous ones.
  • If the URL is unchanged and you omit headers or authorization, the saved values are kept.
  • If any number would exceed the URL limit for an event, nothing changes and the pairs are listed in invalidWebhooks.
  • invalidWabaNumbers lists numbers not found in your organization.
  • Fails if the webhook does not belong to your organization.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The webhook ID

Body Params
uri
required

URL of the webhook

string
enum
required

HTTP method used for the webhook

Allowed:
headers
object

Custom headers to be sent with the webhook

body
object

Payload to be sent with the webhook

query
object

Query parameters to be included in the webhook URL

string
enum

Format of the body content

Allowed:
authorization
object

Authorization details for the webhook

webhookEvents
array of strings
required

Events that trigger the webhook

webhookEvents*
boolean

Retry the webhook call on timeout

string
required

Name of the webhook

wabaNumbers
array of strings
required

List of WABA numbers associated with the webhook

wabaNumbers*
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json