EmailOctopus · Rate Limits

Emailoctopus Rate Limits

EmailOctopus publishes its v2 rate limit precisely. Verbatim from the API reference: "Requests to the API are subject to a rate limit, which is implemented using the token bucket algorithm. Each request consumes one token and your bucket holds up to 100 tokens. Tokens are replenished at a rate of 10 per second." That is a sustained 10 requests per second with a burst of 100. Exceeding it returns HTTP 429 (too-many-requests); the knowledge base adds that the connection is blocked "for up to a minute". Separately, plan-level subscriber and monthly-send caps apply and surface as a 422 out-of-limits error rather than a 429.

Emailoctopus Rate Limits is the machine-readable rate-limit profile for EmailOctopus on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 5 rate-limit definitions, measuring requests, emails, subscribers, and records.

The profile also includes 5 backoff/retry policies defined and response codes documented for throttled and quota_exceeded.

Tagged areas include Email, Email Marketing, Newsletters, Campaigns, and Automation.

5 Limits Throttle: 429
EmailEmail MarketingNewslettersCampaignsAutomationRate LimitingQuotasThrottling

Limits

Sustained Request Rate account
requests
10
Token replenishment rate. Verbatim, "Tokens are replenished at a rate of 10 per second."
Burst Capacity account
requests
100
Bucket size. "your bucket holds up to 100 tokens" — a burst of up to 100 requests in a single instance is permitted before throttling begins.
Monthly Email Volume account
emails
plan-dependent
Free Starter plan allows 10,000 emails per month; Pro raises this by plan.
Subscribers account
subscribers
plan-dependent
Free Starter plan caps at 2,500 subscribers; Pro pricing scales with subscriber count. Exceeding the cap through the API returns 422 out-of-limits.
Pagination request
records
100
Collection endpoints return a maximum of 100 results per page in the `data` attribute, paged with the `limit` and `starting_after` cursor parameters.

Policies

Token Bucket
One token per request; bucket of 100; refill 10/second. Enables a steady 10 rps or an occasional burst of 100.
Blocking Window
Exceeding the limit returns 429 and blocks the connection for up to one minute (knowledge base, article 91).
Backoff Strategy
Honour 429 responses, read X-RateLimit-Retry-After, and retry with exponential backoff.
Bulk Work Exemption
EmailOctopus states that the dashboard import process is faster than the API for bulk contact loading and is not subject to these limits, and recommends webhooks over polling for change sync.
Plan-Based Limits
Sending and subscriber limits are determined by the account's plan tier.

Sources