Hoppa till innehållet

Reference

Limits

Every limit an account meets, with its number. When a send meets one, Errors says what the refusal looks like. To raise a per-minute limit, the test servers’ limits, the number of servers or a limit marked “unless Sendora sets another”, write to support.

Sending rates and the monthly cap

Emails are counted one per recipient, across to, cc and bcc, and a month is a calendar month in UTC.

LimitValue
Per minute, per account300 by default
Monthly capSet at approval from the monthly volume the application named: 10,000, 50,000, 250,000 or 1,000,000; above that, a figure Sendora sets
Highest monthly cap10 times the cap approval set, unless Sendora sets another
WarningA cap_warning webhook at 80 percent of the cap, once a month
  • An administrator moves the monthly cap under Account › Usage, anywhere up to the highest. Write to support to go past that.
  • An account approved without an application starts at the monthly cap of the smallest volume.
  • Sendora can give a server a per-minute limit and a monthly cap of its own, only ever tighter than the account’s.
  • A broadcast counts in full against the monthly cap as soon as Sendora accepts it. The per-minute limit does not apply to broadcasts.

Test servers

LimitValue
Per minute, all the account’s test servers300 by default
Per month, all the account’s test servers10,000 by default

Test mail never counts toward the account’s monthly cap. A refusal under these limits has the scope test.

Account

ObjectLimit
Servers10 by default, more on request
Keys2 live per server, and 2 live account keys
Webhook secrets2 live per webhook
Inbound streamsOne live per server
Names of servers, streams, keysUp to 100 characters

Sending domains, webhooks and transactional and broadcast streams have no limit of their own.

Requests

LimitValue
Request body10 MB, and 64 MB for POST /v1/broadcasts
Idempotency-KeyUp to 255 printable characters, remembered for 24 hours
BatchUp to 100 messages

Messages

LimitValue
Recipients50, across to, cc and bcc
Size10 MB as built, with attachments counted after base64 encoding
Subject998 characters
Attachments20
Custom headers20
Metadata20 entries, keys of up to 40 characters, values of up to 500
TagUp to 100 characters

Broadcasts

LimitValue
Messages50,000 per broadcast
Size50 MB for the whole broadcast as built, and 10 MB for each message in it
Substitutions20 per message, each up to 500 characters
Pace600 messages a minute per broadcast stream, unless Sendora sets another
The brakeThe stream pauses when complaints pass 0.1 percent of its deliveries in the last 24 hours, once those are at least 1,000

SMTP submission

LimitValue
Connections200 at once on each listener
IdleA connection is closed after 60 seconds
Message10 MB and 50 recipients, as over the API

Inbound mail

LimitValue
Size35 MB per message
Rate300 recipients a minute per account, unless Sendora sets another
Recipients50 per delivery from a sending server
Connections300 a minute from one sending server
Content keptThe stream’s contentRetentionDays, 1 to 30 days, 30 by default
Addressesto and cc hold up to 100 entries each, with the whole number in toCount and ccCount
Domain graceMail to a verified domain whose records went missing is deferred for 72 hours, then refused

If a received message passes one of these limits, Sendora still keeps it whole. parseIssue says which limit, and you can download the raw message while the stream keeps its content:

Parser limitValue
Header block256 KB and 1,000 lines
Parts500 MIME parts, nested up to 50 deep
Text and HTML1 MB of text and 2 MB of HTML once decoded
Decoded content4 times the size of the message as received
Time20 seconds to parse
AttachmentsThe first 100 are kept
Header valuesThe first 2,000 characters are kept
Address listsThe first 1,000 addresses are kept

If a message passes the header, part, size or time limit, its parsed text, HTML and attachments are empty. If it passes one of the last three, Sendora parses it and leaves out the rest.

Retention

WhatKept for
A message’s text and HTML30 days
Its attachments’ contentUntil Sendora’s mail server has the message, or it has failed
The message, its recipients and events, and a received message’s reference13 months
On a test server7 days for the text and HTML, 30 days for the rest

Webhooks

LimitValue
Timeout10 seconds for an answer; a redirect is not followed and counts as a failure
RetriesAfter 30 seconds, 2 minutes, 10 minutes, 30 minutes, 1 hour, 3 hours, 6 hours and 12 hours; then the delivery is dead until you replay it

Page sizes

ListsPage size
Messages, received messages, broadcastsUp to 100, 50 by default
Suppressions, webhook deliveriesUp to 1,000, 100 by default

Sign-in

LimitPer 15 minutes
Sign-in tries10 per address, 30 per client
Mailed links3 per address, 10 per client
Invitations3 per address, 20 per client

Requests per second

Before any request reaches the API, the proxy holds each client to 20 requests a second, with bursts of up to 50, and each body to the sizes under Requests. Its refusals are plain text, not JSON: 429 Too Many Requests and 413 Request Entity Too Large.