How do Marketing API rate limits work?
Meta limits Marketing API calls in several ways at once: points per ad account, 100 requests per second on create and edit calls, one edit per object every 30 seconds, hourly quotas by use case, and app-level limits. Your access tier decides the size of the quota. As checked on 2 Oct 2026.
A Marketing API request is not free: Meta counts it against several separate limits, and it takes only one of them to stop a request. This page summarises Meta’s rate limiting page, updated 19 August 2026, as checked on 2 Oct 2026. Meta says the Marketing API has its own rate limiting logic and is excluded from the Graph API’s limits, so Marketing API calls do not count toward Graph API throttling.
Which limits apply to a call?
| Limit | How Meta describes it | Related error |
|---|---|---|
| Ad account points | Generally a read call counts 1 point and a write call 3 points; a throttling error appears at the maximum score | Code 17, subcode 2446079; code 613, subcode 1487742 |
| Create and edit speed | 100 requests per second per app and ad account combination, for campaigns, ad sets and ads | Code 613, subcode 5044001 |
| Same-object edits | One edit per object every 30 seconds by default, per endpoint | Code 613, subcode 4841018 |
| Ads Insights, app level | Determined by the capacity of Meta’s backend infrastructure and downstream services; all Insights calls for the app are limited | Code 4, subcode 1504022 or 1504039 |
| Business Use Case quotas | Per ad account over one hour, by use case | Codes 80000, 80003, 80004 and 80014 |
| Ad set budget changes | 4 changes per hour to daily_budget or lifetime_budget, then blocked for an hour |
Code 613, subcode 1487632 |
| Spending limit changes | 10 changes per day to the account spending limit | Code 17, subcode 1885172 |
| Abuse prevention | Meta may temporarily reduce the quota of accounts producing abnormal traffic | Code 613, no subcode |
Meta adds that app-level limits apply to all of an app’s calls, based on its total users, and return code 4 with the message “Application request limit reached”.
How does your access tier change the numbers?
Meta says the feature that changes your quota is the Marketing API Access Tier. Apps start on Limited access, which Meta calls the development tier, and can upgrade to Full access. See the access tier entry.
| Item (per ad account) | Limited access (development) | Full access |
|---|---|---|
| Maximum score | 60 | 9000 |
| Decay rate | 300 seconds | 300 seconds |
| Blocked when you reach the maximum | 300 seconds | 60 seconds |
ads_management quota per hour |
300 plus 40 per active ad | 100000 plus 40 per active ad |
ads_insights quota per hour |
600 plus 400 per active ad, minus 0.001 per user error | 190000 plus 400 per active ad, minus 0.001 per user error |
Meta also says your limit may depend on total CPU time and total wall time on your ad account.
How can you see how close you are?
Meta points to three response headers:
X-Ad-Account-Usage:acc_id_util_pct,reset_time_durationandads_api_access_tier.X-Business-Use-Case:call_count,total_cputime,total_timeandestimated_time_to_regain_access.X-FB-Ads-Insights-Throttle:app_id_util_pct,acc_id_util_pctandads_api_access_tier.
Meta says most Marketing API requests are subject to Business Use Case limits, and you can tell by looking for an X-Business-Use-Case header.
What should you do when a call is throttled?
- Read the error code and subcode in the response, because code 613 appears under several limits.
- Check the usage headers for how much quota you have used and when it should reset.
- Spread requests evenly instead of sending them in bursts.
- Combine small requests into batch or async requests where the endpoint supports them.
- Retry with exponential backoff, and for same-object edits retry at least 30 seconds apart.
FAQ
Do Marketing API calls count toward Graph API limits?
No. Meta says the Marketing API has its own rate limiting logic and is excluded from all Graph API rate limitations, so a Marketing API call is not counted into Graph API throttling. Its limits are the ones on Meta’s Marketing API rate limiting page.
How often can you change an ad set budget through the API?
Meta says each ad set’s daily_budget and lifetime_budget can change 4 times per hour. Past that, the budget change for that ad set is blocked for an hour, with code 613 and subcode 1487632. Plan bulk budget edits around that limit.
Can you stay under 100 requests per second and still be throttled?
Yes. Meta says the one-edit-per-object-every-30-seconds limit is independent of the 100 requests per second limit on an ad account. Requests can stay under 100 per second and still be throttled when they target a single object.
Sources
- Marketing API rate limiting (Meta, checked 2 Oct 2026)
- Marketing API authorization (Meta, checked 2 Oct 2026)
Drafted with AI and checked claim by claim against the pages linked under Sources. Found a mistake? Tell us via the corrections policy.