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
requests · per_minute
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