Skip to main content
POST

Body Parameters

string
required
Target HTTPS destination URL (e.g. https://agent.example.com/api/webhooks).
string[]
required
Array of event types to subscribe to (e.g. ["email.received", "email.sent", "sms.received"]).
string
Optional agent handle to scope events exclusively to this agent.
string
Optional mailbox address to scope events to a single mailbox.
string
Optional custom bearer token (min 8 chars). When set, Wirebox will send Authorization: Bearer <auth_token>.

Response

Returns the webhook endpoint with its one-time HMAC signing secret.