Message logs, events & webhooks — found from sitemap — Bird Email API (formerly SparkPost)

Cited by

Facts read from this source

• Standard webhooks Report an error

  “Bird follows the Standard Webhooks specification for headers, signing, and payload structure”

• Endpoint creation Report an error

  “Register an endpoint in the dashboard under Platform tools > Webhooks, or from the terminal with the Bird CLI”

• Endpoint constraints Report an error

  “Endpoint URLs must be HTTPS, at most 2048 characters, and publicly reachable.”

• Max event types Report an error

  “The events array lists up to 100 types from the event catalog.”

• Signing secret Report an error

  “The create response includes the endpoint's signing secret (prefixed whsec_) exactly once.”

• Signature algorithm Report an error

  “The signature is an HMAC-SHA256 over the string {webhook-id}.{webhook-timestamp}.{raw request body}, keyed with your endpoint's secret”

• Timestamp tolerance Report an error

  “reject deliveries whose webhook-timestamp is more than 5 minutes old”

• Delivery semantics Report an error

  “Your endpoint has 15 seconds to respond; any 2xx status counts as success, and anything else (including 3xx redirects and timeouts) counts as a failure.”

• Retry schedule Report an error

  “That's eight attempts over roughly 27.5 hours.”

• At least once Report an error

  “Bird delivers at-least-once, so the same delivery can arrive more than once.”

• No ordering Report an error

  “Deliveries are not ordered. An email.delivered can arrive before the email.accepted for the same message”

• Test send Report an error

  “POST /v1/webhooks/{webhook_id}/test sends a signed synthetic event to your endpoint and returns the outcome synchronously”

• Replay Report an error

  “POST /v1/webhooks/{webhook_id}/replay queues redelivery of deliveries that failed.”

• Secret rotation Report an error

  “POST /v1/webhooks/{webhook_id}/rotate-secret generates a new secret and returns it once. For the next 24 hours, Bird signs each delivery with both secrets.”

• Endpoint health Report an error

  “An endpoint that fails continuously for about five days is automatically paused and all delivery stops”

• Degradation emails Report an error

  “we send at most one degradation email per endpoint every 24 hours”

• Event catalog Report an error

  “Event types follow resource.action naming and are grouped by product; each product's events page carries the per-event payload fields:”

• Event envelope Report an error

  “Every delivery body is the Standard Webhooks nested envelope with type, timestamp, and a type-specific data object.”

• Event stability Report an error

  “Event names are never renamed, and new types are added as products ship”

• Crud Report an error

  “Endpoints support full CRUD: list, get, update, and delete.”

• Multiple endpoints Report an error

  “A workspace can register multiple endpoints, each with its own URL, event filter, and secret.”

• No code targets Report an error

  “Any receiver that accepts an HTTPS POST works as a plain endpoint, including a Zapier "Catch Hook", a Make custom webhook, or an n8n Webhook node.”

• Sdk verify Report an error

  “const event = bird.webhooks.unwrap(rawBody, headers);”

• Retry after Report an error

  “A Retry-After header on a failed response can lengthen the next wait.”

• Mcp events Report an error

  “An MCP client such as ChatGPT can subscribe to events itself through MCP Events.”

1 fact read from this page is not shown because it could not be confirmed on the page as captured.

Scores citing this record

• The Agency Lead Message logs, events & webhooks
• The Data Protection Officer Message logs, events & webhooks
• The Shop Operator Message logs, events & webhooks
• The Platform Engineer Message logs, events & webhooks
• The SaaS Developer Message logs, events & webhooks
• The Skeptic Message logs, events & webhooks