POST/v1/webhook-endpoints/{id}/test

testWebhookEndpoint

Send a test delivery. Sends a synthetic `webhook.test` event to the endpoint, signed exactly like a real delivery (Standard-Webhooks headers over the raw body). Use it to verify your signature handling before subscribing to real events. Disabled endpoints return 409 `resource_conflict`.

Required scope:webhooks:write

Parameters

idpath · stringrequired

Webhook endpoint id.

Responses

200TestWebhookEndpointResult

The test delivery outcome.

400invalid_request validation_failed

401authentication_required invalid_api_key

403insufficient_scope feature_not_enabled

404resource_not_found

409resource_conflict

429rate_limited quota_exhausted

500internal_error

Errors are RFC 9457 problem+json with a stable code and a request_id — each code above links to its own page.

Example

POST /v1/webhook-endpoints/{id}/test

curl -X POST https://app.usepostify.com/v1/webhook-endpoints/post_9x2y3z0001/test \
  -H "Authorization: Bearer postify_live_XXXXXXXXXXXXXXXX"