beehiiv · Rate Limits
Beehiiv Rate Limits
beehiiv enforces a single global rate limit on the v2 REST API at 180 requests per minute per organization, returning 429 with IETF-draft RateLimit-* headers.
Beehiiv Rate Limits is the machine-readable rate-limit profile for beehiiv on the APIs.io network, conforming to the API Commons Rate Limits specification.
It captures 1 rate-limit definition, measuring requests.
The profile also includes 3 backoff/retry policies defined and response codes documented for throttled.
Tagged areas include Newsletter, Creator, Email, Subscription, and Publishing.
1 Limits
Throttle: 429
NewsletterCreatorEmailSubscriptionPublishingRate LimitingQuotasThrottling
Limits
Organization Request Rate organization
180
180 requests / 60 seconds = 3 req/sec. beehiiv recommends pacing requests at ~350ms intervals to stay under the limit proactively.
Policies
Exponential Backoff
On 429 responses, retry with exponential backoff and jitter. Honor RateLimit-Reset to know when the window resets.
Proactive Throttling
Client SDKs and integrations should self-pace at roughly 3 req/sec (one request per ~333-350ms) instead of waiting for 429 responses.
Per-Organization Aggregation
All API keys and OAuth tokens within a single beehiiv workspace/organization share the same 180 req/min bucket.
Sources
- https://developers.beehiiv.com/welcome/rate-limiting
- https://developers.beehiiv.com/welcome/getting-started
- https://developers.beehiiv.com/llms.txt
Work with this as data
Every rate limit here is available over the APIs.io API and to AI agents over MCP.