Skip to Content
API & MCPPOSTSend a test event

REST API

Send a test event

Queue ONE test delivery to the subscription's endpoint.

POST/v1/subscriptions/:subscription_id/test
MCP tool send_test_eventscope webhooks:writeNo record cost

Parameters

subscription_idstringrequired

What your agent reads

The tool description exactly as an MCP client receives it in tools/list — it doubles as the full behaviour of the endpoint.

Queue ONE test delivery to the subscription's endpoint: the last delivered payload of this subscription if there is one, else a synthetic sample built from the catalogue and the field registry — always with `test: true` in the envelope, signed like a real event. No record cost. Returns match_id and delivery_id; list_subscription_matches shows the HTTP outcome. Test deliveries retry at most 3 times and never trip the endpoint's breaker.

Errors follow one format.