Retrieve a webhook
GET
/webhooks/{id}Authorization
AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
Path parameters
idstring<uuid>requiredResponses
200
Webhook, including its signing secret
idstring<uuid>requiredendpointstringrequiredcreated_atstringrequiredstatusstringrequiredAllowed:
enableddisabledeventsstring[] | nullrequiredinbox_idsstring[] | nullrequiredBillionSend extension: inbox events and email.received reach this endpoint only for these inboxes of the team (at most 100). null means every inbox.
objectstringrequiredAllowed:
webhooksigning_secretstringNot returned to a team member's MCP call; the dashboard shows members only its last 4 characters
previous_secret_expires_atstring | nullrequiredWhile set, deliveries are also signed with the secret this one replaced (a rotation's overlap window)
401
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequired404
Not found
statusCodenumberrequirednamestringrequiredmessagestringrequired429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired