# Send a test event

Source: https://help.ruuster.com/api/webhooks-test

```http
POST https://api.ruuster.com/v1/webhooks/{webhookId}/test
```

Send a webhook.test event to the subscription's URL now and return what your endpoint answered.

- Authentication: `x-api-key` and `x-email` headers of an owner or admin
- Rate limit: 120 requests per minute per key
- Changes only your webhook subscriptions, never your Ruuster data

No body. The delivery is signed like any other, so it also tests your [signature check](https://help.ruuster.com/api/webhook-verifying).

## Path parameters

| Name | Type | Description |
|---|---|---|
| `webhookId` | string | The subscription id, `whk_…` |

## Response

`deliveryId`, `eventId`, `statusCode` and `latencyMs` of the attempt. On success it also has `responseBodyPreview` (the start of your endpoint's answer); on failure it has `error` instead, for example `Timed out after 10s`.

## Example request

cURL:

```bash
curl -s -X POST "https://api.ruuster.com/v1/webhooks/whk_2c7f9a4e1b/test" \
  -H "x-api-key: $RUUSTER_API_KEY" \
  -H "x-email: $RUUSTER_EMAIL"
```

Node.js:

```javascript
const res = await fetch("https://api.ruuster.com/v1/webhooks/whk_2c7f9a4e1b/test", {
  method: "POST",
  headers: {
    "x-api-key": process.env.RUUSTER_API_KEY,
    "x-email": process.env.RUUSTER_EMAIL,
  },
});
const body = await res.json();
if (!body.ok) throw new Error(`${body.error.code}: ${body.error.message} (${body.requestId})`);
console.log(body.data);
```

Python:

```python
import os
import requests

res = requests.post(
    "https://api.ruuster.com/v1/webhooks/whk_2c7f9a4e1b/test",
    headers={"x-api-key": os.environ["RUUSTER_API_KEY"], "x-email": os.environ["RUUSTER_EMAIL"]},
    timeout=30,
)
body = res.json()
if not body["ok"]:
    raise RuntimeError(f'{body["error"]["code"]}: {body["error"]["message"]} ({body.get("requestId")})')
print(body["data"])
```

## Example response

```json
{ "ok": true, "data": { "deliveryId": "dlv_8e21c4f7a9", "eventId": "evt_test_1b6d0c93", "statusCode": 200, "latencyMs": 184, "responseBodyPreview": "ok" } }
```