# Send a signed test event

`POST /api/v1/webhooks/test`

Sends a signed `ping` event to your URL right now and tells you what your server answered. Use it to set up Make, Zapier or n8n, and to test your signature check.

**Credits:** Free.

## Body (JSON)

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `url` | string | yes | The https URL to send a signed test event ("ping") to. |
| `webhookSecret` | string |  | Optional: sign this webhook with your own secret instead of the account signing secret. |

## Example request

```bash
curl -X POST "https://moleman.io/api/v1/webhooks/test" \
  -H "Authorization: Bearer $MOLEMAN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"url":"https://hooks.example.com/make"}'
```

## Example answer

```json
{
  "delivered": true,
  "statusCode": 200,
  "error": null,
  "signature": "t=1762344000,v1=5f2c…"
}
```

## Errors

| Status | Code | When |
| --- | --- | --- |
| 401 | [`missing_api_key`](/docs/errors#missing_api_key) | The request has no API key. |
| 401 | [`invalid_api_key`](/docs/errors#invalid_api_key) | The API key is not one of ours (a typo, a cut-off copy, or a key from another account that was deleted). |
| 401 | [`revoked_api_key`](/docs/errors#revoked_api_key) | The API key was revoked on the API page. Revoking takes effect at once. |
| 429 | [`rate_limited`](/docs/errors#rate_limited) | More than 120 requests in one minute with this key. |
| 500 | [`server_error`](/docs/errors#server_error) | Something broke on our side. Nothing was charged for it. |
| 400 | [`invalid_request`](/docs/errors#invalid_request) | A parameter is missing, has the wrong type or is out of range. `details` lists every problem with its path. |
| 400 | [`invalid_json`](/docs/errors#invalid_json) | The body is not valid JSON. |
| 409 | [`idempotency_in_progress`](/docs/errors#idempotency_in_progress) | A request with the same Idempotency-Key is still running. |
| 422 | [`idempotency_key_reused`](/docs/errors#idempotency_key_reused) | The Idempotency-Key was already used in the last 24 hours with a different request. |
| 400 | [`invalid_webhook_url`](/docs/errors#invalid_webhook_url) | The webhook URL is not a public https address (private networks and other schemes are refused). |