Queue a test webhook
POST/api/webhooks/:id/test
x-audience: "management"
x-required-scope: "webhooks:write"
No body. Endpoint must be active with a saved revision and signing secret. Asynchronously queues a test payload with type: email.test, schema_version: 2026-09-01, and a 24-hour deadline. It is not a parsed email.received payload. Applies the saved payload mapping, which can omit these fields. A 202 response confirms scheduling. Inspect the delivery to determine success.
Request
Responses
- 202
- 401
- 403
- 404
- 409
- 429
- 503
Success
Missing, invalid or revoked credentials.
Required scope or account access missing.
Endpoint not found.
Endpoint paused or not configured.
Shared client-IP or account request allowance exhausted. Retry after the indicated number of seconds. Browser authentication errors can use a different response format.
Response Headers
no-store
Seconds to wait before retrying.
Request limiting cannot be enforced. Retry later with backoff.
Response Headers
no-store