# Send a Test to an Endpoint

One signed `webhook.test` to one endpoint, right now, with what happened.

## Overview

- Signed and sent like every delivery ([Webhooks & Events](https://docs.aureahub.com/docs/guide-events.md)), whether the endpoint is active or not. The body's `data` holds `tenantId`, `webhookId` (the endpoint's id) and a `message`.
- `delivered` is `true` when your server answered `2xx` within 10 seconds. `statusCode` is your server's answer, or `null` when none came; `error` says why, or is `null`.
- An endpoint with `mtls`: the test presents Aurea's client certificate, as its deliveries do ([Mutual TLS](https://docs.aureahub.com/docs/guide-events.md)).
- Not queued, never retried, and not in the [attempts log](https://docs.aureahub.com/docs/webhook-attempts-list.md). At most **10 a minute**; more answers `429`.
- `404` `WEBHOOK_ENDPOINT_NOT_FOUND` for an endpoint that is not this tenant's. Same roles as [Add an Endpoint](https://docs.aureahub.com/docs/webhook-endpoint-add.md); written to the tenant's activity log with the outcome.

## Endpoint

### `POST /v1/admin/tenants/{id}/webhook-endpoints/{endpointId}/test`

Authentication: bearer token required.

Sends a signed test delivery to the endpoint and reports the outcome. No body.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | Tenant UUID |
| `endpointId` | string | yes | The endpoint's id |

**Responses**

`200` Delivered

```json
{
  "id": "evt_3e8d0b6a91c47f25d0e1a9b8c7f60d42",
  "type": "webhook.test",
  "delivered": true,
  "statusCode": 200,
  "error": null,
  "durationMs": 187
}
```

`429` Too many

```json
{
  "statusCode": 429,
  "error": "Error",
  "message": "Rate limit exceeded, retry in 1 minute"
}
```

---

Web version: https://docs.aureahub.com/#webhook-endpoint-test