Rate Limits

Notifo enforces rate limits per API key and per tenant.

Limits

Rate limits are defined by your subscription plan:

Plan field	Meaning
`msgPerDay`	Maximum messages per 24-hour window
`msgPerMonth`	Maximum messages per calendar month

Individual API keys can have a rateLimitOverride (requests per minute) set at creation time. If not set, the plan default applies.

When you exceed the limit, the API returns:

HTTP/1.1 429 Too Many Requests
Retry-After: 60

{
  "statusCode": 429,
  "message": "Rate limit exceeded"
}

Spread bulk sends — use the bulk endpoint for up to 100 messages per request
Respect Retry-After — back off for the duration indicated in the header
Use idempotency keys — so retries don't double-count against your quota
Monitor usage — check /v1/messages/stats/daily to track your daily volume