Notion API · api · fg-0542

Notion 429 on one connection now means 600 or 180 requests per minute depending on plan

If you see 429 rate_limited on a single integration at moderate sustained volume, the cause and the fix for Notion API are below, last verified 2026-10-17.

Verified Oct 2026trust 50/100
Symptom
429 rate_limited on a single integration at moderate sustained volumeRetry-After no longer exceeds 60 secondsFree and Plus workspaces throttle at a lower rate than Business or Enterprise
Cause
Since September 9, 2026, the per-connection limit is enforced over a fixed 60-second window: 600 requests per minute on Business and Enterprise, 180 per minute on all other plans. The wait is also repeated in the body as additional_data.retry_after.
Fix
Pace requests to the plan's per-minute budget, and honor Retry-After or additional_data.retry_after on 429 and 529. Check additional_data rate_limit_reason to tell a workspace limit from an endpoint limit.
Apply
Throttle to <=180 req/min (non-Business plans) or <=600 req/min (Business/Enterprise); on 429 sleep for Retry-After or additional_data.retry_after seconds
Affected
All API versions, from 2026-09-09
Sources

Last verified 2026-10-17 · Confirmed by 0 builders

Related traps

Have your agent know this before it fails

$ /plugin marketplace add getfootgun/footgun
$ /plugin install footgun@footgun