Monthly Post Quota
The monthly post quota limits how many post requests (POST /post) a profile can send in a calendar month.
- Every profile has its own quota and its own count. The Primary Profile and each User Profile are counted separately.
- The amount depends on your plan. See pricing for each plan’s amount.
- Posts sent from the Ayrshare dashboard count too.
When the Quota Resets
The monthly post quota resets on the 1st of each calendar month, starting at 00:07 UTC. It can take a few minutes to reach every account. The reset date is the same for every account and is not tied to your billing date.- Paying a renewal invoice does not reset the quota.
- Changing your plan resets your Primary Profile’s count right away. User Profiles keep their count until the 1st.
- If you subscribe mid-month, you start with a fresh count. The next reset is still the 1st.
- The reset uses UTC. In the Americas, it happens on the evening of the last day of the previous month.
What Counts Toward the Quota
- One post request counts as one, no matter how many platforms it targets. A post to five platforms counts as one.
- Failed posts count. If Ayrshare tries to send a post, it counts, even if some or all platforms fail. For example, the social network rejects it or the account is not linked.
- Blocked posts count. Posts that Ayrshare blocks after repeated identical failures on a platform still count.
- Scheduled posts count when they publish, not when you schedule them.
- Requests rejected before sending, such as a request rejected with code 106.
- Posts that fail post verification on every platform they target. If the post passes on at least one platform and is sent, it counts.
When You Run Out
When a profile has used its monthly post quota:- New post requests return HTTP
429withcode: 106. This includes requests that schedule a post for later. - Other post requests also return
code: 106until the reset. For example, getting, deleting or retrying a post, and post analytics. - Scheduled posts that come due fail with
code: 106. They do not publish automatically after the reset. Send them again once the quota resets.
Check Your Usage
Call Get Profile Details (GET /user). To check a User Profile, add its Profile-Key header.
monthlyPostCount: posts counted this month.monthlyPostQuota: the monthly limit. It is omitted when the quota is 10,000 or more, for example on Business plans. The limit still applies.monthlyApiCallsis a different counter. It is not the post quota.
Avoid Using Up Your Quota by Accident
Failed posts count, so a loop that keeps retrying failing posts can use up the whole quota without publishing anything.- Don’t automatically retry errors that will fail again. Fix the cause first, for example relink the account.
- Retry only errors that can succeed on a retry, such as those with
retryAvailable: true, and limit the number of retries. - Check
monthlyPostCountregularly so you notice an unexpected jump.