---
title: "The monthly cap is used up"
method: POST
path: "cap_reached"
tags: ["The monthly cap"]
---

# The monthly cap is used up

`POST cap_reached` (webhook)

A send was refused because the monthly cap is used up.

## Headers

- `Sendora-Signature` string, required
- `Sendora-Event` string, required
- `Sendora-Delivery-Id` string, required
- `User-Agent` string, required

## Payload

- object: A send was refused because the monthly cap is used up.
  - `id` string, required: The delivery's id. A delivery may arrive more than once, so key your handling on it.
  - `attempt` integer, required: The attempt number, from 1.
  - `scope` 'account' | 'server' | 'test', required: Whose cap it is: `account` for the account's, `server` for a server's own, `test` for the cap the account's test servers share.
  - `serverId` string, nullable, required: The server whose cap it is; null for the account's or the test servers' cap.
  - `cap` integer, required: Emails the scope may send in the month.
  - `used` integer, required: Emails sent in the month so far.
  - `periodStart` string, date-time, required: The month the counts are for: its first moment, in UTC.
  - `periodEnd` string, date-time, required: The first moment of the next month, in UTC.
  - `occurredAt` string, date-time, required: When it happened.
  - `event` 'cap_reached', required

## Acknowledgement `2XX`

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

---

[API](https://skmtc.dev/sendora/apis/sendora-api.md) · [All operations](https://skmtc.dev/sendora/apis/sendora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sendora/apis/sendora-api/revisions/72efbbb34b64?raw)