# Send a test event

`POST /api/webhook/outbound/test`  (operationId: `testWebhook`, group: Webhooks)

Sends one signed event to the saved endpoint now and reports what it answered. The payload is the catalogue example, marked with test: true. It ignores your subscriptions and plan, so it checks connectivity and signature verification, not entitlement.

Part of the full API, which is included in the Scale plan. Workspace admin: a dashboard session, or a full-access key created by an admin. A scoped key is refused with scope_denied.

**Request body** (JSON)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `event` | string | no | A catalogue event. Default message_received. |

Example:

```json
{
  "event": "message_status"
}
```

**Response 200**: OK (schema `WebhookTestResult`)

| Field | Type | Description |
| --- | --- | --- |
| `ok` | boolean |  |
| `status` | integer, nullable | HTTP status your endpoint returned. |
| `attempts` | integer |  |
| `error` | string, nullable |  |
| `duration_ms` | integer |  |
| `event` | string |  |

Example:

```json
{
  "ok": true,
  "status": 200,
  "attempts": 1,
  "error": null,
  "duration_ms": 184,
  "event": "message_status"
}
```

**Errors specific to this call.** The common ones (401, 403, 429 and the rest) are in the [Errors guide](https://inboxwa.online/docs/api/guide/errors.md).

| Status | error | When |
| --- | --- | --- |
| 400 | `unknown_event` | Not a catalogue event. |
| 404 | `not_configured` | Save an endpoint first. |

Part of the InboxWA API reference: https://inboxwa.online/docs/api . Full reference as one document: https://inboxwa.online/docs/api.md . OpenAPI: https://inboxwa.online/openapi.json