Reference · Webhooks

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

Shell

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://hook.eu2.make.com/abc123"}'

Example answer

JSON

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

Errors

Status	Code	When
401	`missing_api_key`	The request has no API key.
401	`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`	The API key was revoked on the API page. Revoking takes effect at once.
429	`rate_limited`	More than 120 requests in one minute with this key.
500	`server_error`	Something broke on our side. Nothing was charged for it.
400	`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`	The body is not valid JSON.
409	`idempotency_in_progress`	A request with the same Idempotency-Key is still running.
422	`idempotency_key_reused`	The Idempotency-Key was already used in the last 24 hours with a different request.
400	`invalid_webhook_url`	The webhook URL is not a public https address (private networks and other schemes are refused).