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

# Test a Webhook Endpoint

> Sends a test ping event to a webhook endpoint.

Requires the `webhooks:write` scope. Sends a `ping` event to the endpoint so you can confirm your server receives and verifies deliveries. The delivery is queued and processed asynchronously — inspect the result in the [delivery log](/api-reference/webhooks/deliveries).

### Path parameters

<ParamField path="id" type="string" required>
  The id of the webhook endpoint to ping.
</ParamField>

### Response

Returns `202 Accepted`.

<ResponseField name="delivery_id" type="string">
  The id of the queued test delivery. Look it up in the [delivery log](/api-reference/webhooks/deliveries).
</ResponseField>

<ResponseField name="status" type="string">
  Always `pending` in this response.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request POST 'https://api.audienceful.com/v2/webhooks/wYt3nKq8Zs4pLm9vRb2xJc/ping' \
  --header 'X-Api-Key: <your-api-key>'
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.audienceful.com/v2/webhooks/wYt3nKq8Zs4pLm9vRb2xJc/ping"
  headers = {
      "X-Api-Key": "<your-api-key>",
  }

  response = requests.post(url, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.audienceful.com/v2/webhooks/wYt3nKq8Zs4pLm9vRb2xJc/ping", {
    method: "POST",
    headers: {
      "X-Api-Key": "<your-api-key>",
    },
  });
  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "delivery_id": "dLm4vRb2xJcwYt3nKq8Zs4",
    "status": "pending"
  }
  ```
</ResponseExample>