---
title: "Set Webhook URL for WhatsApp"
slug: "set-webhook-url-for-whatsapp"
description: "Learn how to set the webhook URL for WhatsApp in Insider One’s InOne to receive event notifications and enable real-time message and status updates."
updated: 2026-10-09T11:53:00Z
published: 2026-10-09T11:53:00Z
canonical: "academy.insiderone.com/set-webhook-url-for-whatsapp"
---

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

# Set Webhook URL for WhatsApp

After generating your API Key, set your webhook URL in the account’s API settings to ensure successful message delivery and event tracking for WhatsApp.

> [!WARNING]
> Important notes:
> 
> - Make sure to allow Insider One IP addresses on your server to receive webhook requests successfully.
> - Your system must respond with 200 OK to our request for the webhook to be saved and function correctly.
> - Test webhook URLs can be used temporarily to trigger test messages, but they may become outdated and cause errors. For reliable delivery, we recommend entering the actual webhook URL and sending a test message to yourself.
> - If your endpoint closes the connection before it responds (for example, with a "connection reset by peer" error), check your firewall, API gateway, TLS settings, and IP allowlist.

## Configure your webhook URLs

Follow the steps below to configure your credentials for sending messages via Conversational and Transactional APIs:

1. Navigate to **WhatsApp** > **Settings**.

![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-SULAL03C.png)
2. Click the **Account APIs** icon under the Actions column.

![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-E1S397R5.png)
3. In the Account APIs panel, you can configure separate webhook URLs for:

- [Conversational API](/docs/whatsapp-conversational-api) (for marketing and chatbot use cases)
- [Transactional API](/docs/whatsapp-transactional-api) (for transactional messages)
- [Verify API](/v1/docs/otp-for-whatsapp) (for OTP use cases)

![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-RH8HA6JZ.png)

Ensure you enter the correct credentials and webhook URLs for each use case to start receiving event callbacks for the messages sent via API.

## Sample Webhook Validation Request

Below is the sample validation request we send to your webhook endpoint. Your system must return 200 OK for the webhook to be saved:

```bash
curl --location '{{WEBHOOK_URL}}' \
--header 'Authorization: {{BEARER_TOKEN}}' \
--header 'Content-Type: application/json' \
--data '{
    "partner": "{{PARTNER_NAME}}",
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": 12345,
            "changes": [
                {
                    "field": "webhook_validation",
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "{{ACCOUNT_PHONE_NUMBER}}",
                            "phone_number_id": "{{ACCOUNT_PHONE_NUMBER_ID}}"
                        }
                    }
                }
            ]
        }
    ]
}'
```

## Related

- [Generate API Key for WhatsApp](/generate-api-key-for-whatsapp.md)