Send a test event
POST
/v1/webhooks/{webhook_id}/test
cURL
curl -X POST "https://us1.platform.bird.com/v1/webhooks/{webhook_id}/test" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"event_type": "email.delivered"
}'Sends a synthetic, fully-signed test event directly to the endpoint and returns the outcome synchronously. Use this to verify your endpoint is reachable and your signature verification is correct. The response reports whether your endpoint accepted the event, the HTTP status it returned, and the round-trip latency — an unreachable endpoint is reported in the response body, not as a request error.
Corpo da requisição
event_type
string
Event type to simulate. Defaults to a generic test ping if omitted.
Response Payload
status
string
required
Whether your endpoint accepted the test event. delivered means it returned a 2xx status; failed means it returned a non-2xx status or could not be reached.
response_status_code
nullable integer
required
HTTP status returned by your endpoint. Null when no response was received (timeout, connection error, DNS failure).
response_body
string
Response body returned by your endpoint, truncated when oversized. Empty when no body was returned.
response_duration_ms
integer
required
Round-trip delivery latency in milliseconds.
event_payload
object
The event body Bird delivered to the endpoint. Set on successful test delivery only.
Show child attributes
event_payload.type
string
required
Event type.
event_payload.timestamp
string
required
When the event occurred.
event_payload.data
object
required
Event payload. The fields for this event are not yet finalized.
error
string
A short explanation of why the event could not be delivered. Present only when your endpoint could not be reached.