Skip to content
Esc
↑↓navigate↵open⌘Jpreview

Retrieve a webhook

GET/webhooks/{id}
Authorization
AuthorizationBearer token · headerrequired

A BillionSend API key (bs_…).

Path parameters
idstring<uuid>required
Responses
200

Webhook, including its signing secret

idstring<uuid>required
endpointstringrequired
created_atstringrequired
statusstringrequired
Allowed:enableddisabled
eventsstring[] | nullrequired
inbox_idsstring[] | nullrequired

BillionSend extension: inbox events and email.received reach this endpoint only for these inboxes of the team (at most 100). null means every inbox.

objectstringrequired
Allowed:webhook
signing_secretstring

Not returned to a team member's MCP call; the dashboard shows members only its last 4 characters

previous_secret_expires_atstring | nullrequired

While set, deliveries are also signed with the secret this one replaced (a rotation's overlap window)

401

Missing, malformed, unknown or revoked API key

statusCodenumberrequired
namestringrequired
messagestringrequired
404

Not found

statusCodenumberrequired
namestringrequired
messagestringrequired
429

Over the rate limit (rate_limit_exceeded, with Retry-After)

statusCodenumberrequired
namestringrequired
messagestringrequired
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.billionsend.com/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "endpoint": "string",
  "created_at": "string",
  "status": "enabled",
  "events": [
    "string"
  ],
  "inbox_ids": [
    "string"
  ],
  "object": "webhook",
  "signing_secret": "string",
  "previous_secret_expires_at": "string"
}

Was this page helpful?