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

# Test a Webhook Endpoint

> Send a test event to a webhook endpoint

Send a test event to one of your webhook endpoints, to confirm it's receiving and can handle Relaybase events correctly.

## Request

```http theme={null}
POST https://api.tryrelaybase.com/v1/webhooks/test
Authorization: Bearer rb_key_<token>
Content-Type: application/json
```

```json theme={null}
{
  "test_type": "bulk_validate_success",
  "webhook_id": "b6712266-6e2b-4b5c-b320-1cb7e6e4e00a"
}
```

### Body parameters

| Field        | Type   | Required | Description                                                                                                                      |
| ------------ | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `test_type`  | string | Yes      | One of `test_webhook`, `bulk_validate_success`, `bulk_validate_failed`                                                           |
| `webhook_id` | string | Yes      | The `id` of the webhook endpoint to send the test event to — see [List Webhook Endpoints](/api-reference/webhooks/list-webhooks) |

## Response

Relaybase sends an event to your endpoint matching the `test_type` you requested. The event shape depends on which type you chose:

```json test_webhook → webhook.test theme={null}
{
  "id": "1bf3c66b-8005-423d-a430-0645f3ebd70c",
  "type": "webhook.test",
  "created_at": "2026-08-30T22:30:57.374920312Z",
  "data": {
    "message": "This is a test webhook event from RelayBase. If you received this, your webhook is working correctly."
  }
}
```

```json bulk_validate_success → bulk.validation.completed theme={null}
{
  "id": "a1b8dda9-b258-42fb-8c0f-f01be23bc8b5",
  "type": "bulk.validation.completed",
  "created_at": "2026-08-30T22:31:14.926317556Z",
  "data": {
    "completed_at": "2026-08-30T20:05:32Z",
    "invalid": 158,
    "job_id": "bulk_2x9p",
    "processed": 1000,
    "started_at": "2026-08-30T20:00:00Z",
    "status": "completed",
    "total_emails": 1000,
    "valid": 842
  }
}
```

```json bulk_validate_failed → bulk.validation.failed theme={null}
{
  "id": "460461e1-ec29-4bc1-b6c3-6e5bb37ef956",
  "type": "bulk.validation.failed",
  "created_at": "2026-08-30T21:48:01.649292413Z",
  "data": {
    "error": "Validation process failed unexpectedly.",
    "job_id": "bulk_2x9p",
    "processed": 347,
    "status": "failed",
    "total_emails": 1000
  }
}
```

<Note>
  These test payloads are simulated for testing purposes — sending a test event doesn't mean the referenced job (e.g. `bulk_2x9p`) is a real validation job in your account.
</Note>