> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wadial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create webhook

> Create a signed webhook endpoint.

The response includes `signingSecret` once. Store it server-side and use it to verify `wadial-signature`.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.wadial.com/api/v1/webhooks" \
    -H "Authorization: Bearer $WADIAL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"url":"https://example.com/wadial/webhook","events":["message.received","message.receipt","connection.state"]}'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "data": {
      "id": "019f...",
      "url": "https://example.com/wadial/webhook",
      "events": ["message.received", "message.receipt", "connection.state"],
      "signingSecret": "whsec_..."
    }
  }
  ```
</ResponseExample>