Webhooks

Webhook endpoints for receiving events

Get Multi-Webhook Configuration

get

Retrieve multi-destination webhook configuration including all enabled destinations.

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

application/json

enabledbooleanOptional

401

Unauthorized

application/json

409

Multi webhook is disabled

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 Multi-Webhook

post

Enable multi-destination webhook and configure initial destinations.

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

enabledbooleanRequired

Responses

200

Operation started successfully

application/json

messagestringOptional

400

Bad request - already enabled or validation failed

application/json

401

Unauthorized

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: 107

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

{
  "message": "text"
}

Add Multi Webhook Destinations

put

Add additional destinations to existing multi-webhook configuration.

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

Responses

200

Operation started successfully

application/json

messagestringOptional

400

Bad request - duplicate names or limit exceeded

application/json

401

Unauthorized

application/json

409

Multi webhook is disabled

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: 92

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

{
  "message": "text"
}

Update a Multi Webhook Destination

patch

Update an existing webhook destination configuration by name.

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

namestringRequired

urlstringRequired

Responses

200

Operation started successfully

application/json

messagestringOptional

400

Bad request

application/json

401

Unauthorized

application/json

404

Destination not found

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: 73

{
  "headers": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "name": "text",
  "url": "text"
}

{
  "message": "text"
}

Delete a Multi Webhook Destination

delete

Delete a webhook destination from multi-webhook configuration by name.

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

Destination name to delete

Responses

200

Operation started successfully

application/json

messagestringOptional

400

Bad request

application/json

401

Unauthorized

application/json

404

Destination not found

application/json

409

Multi webhook is disabled

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

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

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

urlstringOptionalExample: https://example.com/webhook

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: 82

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

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

Get WABA Webhook Configuration

get

Retrieve WhatsApp Business Account webhook configuration from Platform API.

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

phone_numbersstring[]Optional

urlstringOptionalExample: https://example.com/webhook

waba_idstringOptionalExample: <waba_id>

401

Unauthorized

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"
  },
  "phone_numbers": [
    "text"
  ],
  "url": "https://example.com/webhook",
  "waba_id": "<waba_id>"
}

Set WABA Webhook Configuration

post

Configure WhatsApp Business Account webhook settings via Platform 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

phone_numbersstring[]Optional

urlstringOptionalExample: https://example.com/webhook

waba_idstringOptionalExample: <waba_id>

Responses

200

Webhook configuration updated successfully

application/json

phone_numbersstring[]Optional

urlstringOptionalExample: https://example.com/webhook

waba_idstringOptionalExample: <waba_id>

400

Bad request

application/json

401

Unauthorized

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: 129

{
  "headers": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "phone_numbers": [
    "text"
  ],
  "url": "https://example.com/webhook",
  "waba_id": "<waba_id>"
}

{
  "headers": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "phone_numbers": [
    "text"
  ],
  "url": "https://example.com/webhook",
  "waba_id": "<waba_id>"
}

Receive Webhook

post

Receive and forward webhook events from Meta to configured webhook destination with custom headers.

Authorizations

-

Body

application/json

Responses

200

Webhook forwarded successfully

application/json

objectOptional

400

Bad request

application/json

401

Unauthorized

application/json

post

/webhook

HTTPcURLJavaScriptPython

POST /webhook HTTP/1.1
Host: waba-v2.360dialog.io
Content-Type: application/json
Accept: */*
Content-Length: 1155

{
  "entry": [
    {
      "changes": [
        {
          "field": "text",
          "value": {
            "calls": [
              {
                "direction": "text",
                "event": "text",
                "from": "text",
                "id": "text",
                "timestamp": 1,
                "to": "text"
              }
            ],
            "errors": [
              {
                "code": 1,
                "error_data": {
                  "details": "text",
                  "messaging_product": "text"
                },
                "fbtrace_id": "text",
                "message": "text",
                "title": "text",
                "type": "text"
              }
            ],
            "message_echoes": [
              {
                "from": "text",
                "id": "text",
                "timestamp": "text",
                "to": "text",
                "type": "text"
              }
            ],
            "messages": [
              {
                "errors": [
                  {
                    "code": 1,
                    "error_data": {
                      "details": "text",
                      "messaging_product": "text"
                    },
                    "fbtrace_id": "text",
                    "message": "text",
                    "title": "text",
                    "type": "text"
                  }
                ],
                "from": "text",
                "id": "text",
                "referral": {
                  "source_id": "text"
                },
                "timestamp": "text",
                "type": "text"
              }
            ],
            "metadata": {
              "display_phone_number": "text",
              "phone_number_id": "text"
            },
            "statuses": [
              {
                "conversation": {
                  "category": "text",
                  "expiration_timestamp": "text",
                  "id": "text"
                },
                "errors": [
                  {
                    "code": 1,
                    "error_data": {
                      "details": "text",
                      "messaging_product": "text"
                    },
                    "fbtrace_id": "text",
                    "message": "text",
                    "title": "text",
                    "type": "text"
                  }
                ],
                "id": "text",
                "pricing": {
                  "category": "text",
                  "pricing_model": "text"
                },
                "recipient_id": "text",
                "status": "text",
                "timestamp": "text"
              }
            ],
            "user_preferences": [
              {
                "timestamp": "text",
                "value": "text",
                "wa_id": "text"
              }
            ]
          }
        }
      ],
      "id": "text"
    }
  ]
}

{}