Webhooks

Webhook endpoints for receiving events

Get Multi-Webhook Configuration

get

Retrieves all configured additional webhooks including their names, URLs, and custom headers.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Responses

200

Multi-webhook configuration retrieved successfully

application/json

Response containing the multi-webhook enabled state and all configured destinations

enabledbooleanOptionalExample: true

401

Unauthorized - Invalid or missing D360-API-KEY

application/json

409

Multi webhook is disabled - use POST to enable it first

application/json

get

/multi_webhook

HTTPcURLJavaScriptPython

GET /multi_webhook HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{
  "destinations": [
    {
      "headers": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "name": "text",
      "url": "text"
    }
  ],
  "enabled": true
}

Enable/Disable Multi-Webhook

post

Enable or disable the multi-webhook feature. When enabling, you can optionally provide initial destinations. If already enabled, use PUT to add more destinations. Destination names must be unique.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Body

application/json

objectOptional

or

Responses

200

Operation started successfully

application/json

messagestringOptional

400

Bad request - already enabled, duplicate destination names, or max destinations exceeded

application/json

401

Unauthorized - Invalid or missing D360-API-KEY

application/json

500

Internal server error

application/json

post

/multi_webhook

HTTPcURLJavaScriptPython

POST /multi_webhook HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "message": "text"
}

Append Webhook Destinations

put

Append additional destinations to the existing multi-webhook configuration. Multi-webhook must be enabled first via POST. Destination names must be unique and not conflict with existing ones. Total destinations cannot exceed the configured maximum.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Body

application/json

objectOptional

or

Responses

200

Operation started successfully

application/json

messagestringOptional

400

Bad request - duplicate destination name or max destinations exceeded

application/json

401

Unauthorized - Invalid or missing D360-API-KEY

application/json

409

Multi webhook is disabled - use POST to enable it first

application/json

500

Internal server error

application/json

put

/multi_webhook

HTTPcURLJavaScriptPython

PUT /multi_webhook HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "message": "text"
}

Update a Webhook Destination

patch

Updates specific properties (url, headers) of an existing webhook destination identified by name. Multi-webhook must be enabled first via POST.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Body

application/json

objectOptional

or

Responses

200

Operation started successfully

application/json

messagestringOptional

400

Bad request - invalid payload

application/json

401

Unauthorized - Invalid or missing D360-API-KEY

application/json

404

Destination not found - no destination with the given name

application/json

409

Multi webhook is disabled

application/json

500

Internal server error

application/json

patch

/multi_webhook

HTTPcURLJavaScriptPython

PATCH /multi_webhook HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "message": "text"
}

Delete a Webhook Destination

delete

Deletes a specific webhook destination from the multi-webhook configuration by its name. Multi-webhook must be enabled first via POST.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

dest_namestringRequired

Name of the webhook destination to delete

Responses

200

Destination deleted successfully

application/json

messagestringOptional

400

Bad request - dest_name is required

application/json

401

Unauthorized - Invalid or missing D360-API-KEY

application/json

404

Destination not found - no destination with the given name

application/json

409

Multi webhook is disabled - use POST to enable it first

application/json

500

Internal server error

application/json

delete

/multi_webhook/{dest_name}

HTTPcURLJavaScriptPython

DELETE /multi_webhook/{dest_name} HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{
  "message": "text"
}

Get Customer Webhook Configuration

get

Retrieve customer webhook configuration. More info on webhook configuration can be found in our documentation: https://docs.360dialog.com/docs/waba-messaging/webhook#get-webhook-url.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Responses

200

Webhook configuration retrieved successfully

application/json

urlstringOptionalExample: https://example.com/webhook

401

Unauthorized

application/json

500

Internal server error

application/json

get

/v1/configs/webhook

HTTPcURLJavaScriptPython

GET /v1/configs/webhook HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{
  "headers": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "url": "https://example.com/webhook"
}

Set Customer Webhook Configuration

post

Configure customer webhook settings. More info on webhook configuration can be found in our documentation: https://docs.360dialog.com/docs/waba-messaging/webhook#via-api.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Body

application/json

objectOptional

or

Responses

200

Webhook configuration updated successfully

application/json

urlstringOptionalExample: https://example.com/webhook

400

Bad request

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

post

/v1/configs/webhook

HTTPcURLJavaScriptPython

POST /v1/configs/webhook HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "headers": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "url": "https://example.com/webhook"
}

Get WABA Webhook Configuration

get

Retrieve the current WABA-level webhook configuration including the URL, custom headers, WABA ID, and phone numbers associated with this WABA.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Responses

200

WABA webhook configuration retrieved successfully

application/json

Current WABA-level webhook configuration including the URL, headers, WABA ID, and associated phone numbers

numbers_on_this_wabastring[]Optional

urlstringOptionalExample: https://example.com/webhook

waba_idintegerOptionalExample: 123065260884961

400

Bad request

application/json

401

Unauthorized - Invalid or missing D360-API-KEY

application/json

500

Internal server error

application/json

get

/waba_webhook

HTTPcURLJavaScriptPython

GET /waba_webhook HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{
  "headers": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "numbers_on_this_waba": [
    "text"
  ],
  "url": "https://example.com/webhook",
  "waba_id": 123065260884961
}

Set WABA Webhook Configuration

post

Configure WABA-level webhook URL and optional headers. When override_all is false, configures the webhook only for Cloud API numbers missing a phone-number-level webhook. When true, the webhook applies across all Cloud API numbers within the WABA. The webhook will be set within 15-20 seconds.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Body

application/json

objectOptional

or

Responses

200

Webhook configuration initiated successfully. Change will be applied within 15-20 seconds.

application/json

Response after initiating WABA webhook configuration. The webhook will be set within 15-20 seconds.

messagestringOptionalExample: Webhook will be set for waba_id: 123065260884961

400

Bad request - Invalid URL or malformed request

application/json

401

Unauthorized - Invalid or missing D360-API-KEY

application/json

500

Internal server error

application/json

post

/waba_webhook

HTTPcURLJavaScriptPython

POST /waba_webhook HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "message": "Webhook will be set for waba_id: 123065260884961"
}