Received mail

Received mail nears the monthly cap

80 percent of the monthly cap on received mail is used.

postWebhookinbound_cap_warning

Headers

Sendora-Signaturestring required

t= the Unix time of sending, then v1= an HMAC-SHA256 over <t>.<body> for each live secret of the webhook, the newest first. Verify one before you trust the body.

Sendora-Eventstring required

The event, the same as event in the body.

Sendora-Delivery-Idstring required

The delivery, the same as id in the body and on every retry of it.

User-Agentstring required

Sendora-Webhooks/1.

Payload

idstring required

The delivery's id. A delivery may arrive more than once, so key your handling on it.

attemptinteger required

The attempt number, from 1.

capinteger required

Emails the account may receive in the month.

usedinteger required

Emails received in the month so far.

periodStartstring date-time required

The month the counts are for: its first moment, in UTC.

periodEndstring date-time required

The first moment of the next month, in UTC, when received mail is counted from 0 again.

occurredAtstring date-time required

When it happened.

event'inbound_cap_warning' required

Example payload

{
  "id": "6f8a0b2c-4e6f-4a8b-9c0d-2e4f6a8b0c1d",
  "attempt": 1,
  "cap": 50000,
  "periodStart": "2026-09-01T00:00:00.000Z",
  "periodEnd": "2026-10-01T00:00:00.000Z",
  "used": 40000,
  "occurredAt": "2026-09-24T09:30:00.000Z",
  "event": "inbound_cap_warning"
}

Response

Acknowledges the delivery. Any other answer, or none within 10 seconds, is retried.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.