SubsiMail
Why self-host Pricing Docs Support FAQ Log in Get a license
Log in Get a license

← Back to Support

Getting 429 Too Many Requests on the campaigns API

#5 Resolved
Steven Y. 150 days ago

I'm scripting a bulk update to about 3,000 contacts using the API and started getting 429 Too Many Requests responses partway through. Is there a documented rate limit I should be working within?

Melissa Rodriguez Staff 150 days ago

Yep — the API is limited to 60 requests per minute per API key. At 3,000 contacts that'll definitely trip it if you're firing requests as fast as possible. A couple of options:

  • Add a short delay (roughly 1 second) between requests to stay under the limit.
  • Use the bulk contacts endpoint instead of one request per contact — it accepts up to 500 contacts per call, so 3,000 contacts is 6 requests instead of 3,000.

The response also includes a Retry-After header when you do get a 429, telling you exactly how many seconds to wait before retrying.

Steven Y. 149 days ago

Didn't realize there was a bulk endpoint, that's much better. One follow-up: does the bulk endpoint still count as 1 request against the per-minute limit, or does it count per-contact internally?

Melissa Rodriguez Staff 149 days ago

Just 1 request against the limit, regardless of how many contacts are in the payload (up to the 500 max). So batching is strictly better for both your rate limit budget and your total request count.

This ticket has been resolved. Its author or SubsiMail staff can reopen it to reply further.

Other tickets

In Progress My domain shows up on a spam blacklist, how do I get delisted?
Samuel W. 3 replies
Resolved SMTP timeout errors when sending large batches
Amanda P. 3 replies
Resolved How do I fetch reply/bounce status for a specific contact via API?
William C. 1 reply
In Progress Randomly logged out on mobile but not desktop
Barbara R. 2 replies
Resolved Is my SMTP password stored securely?
Nancy H. 1 reply

SubsiMail

The self-hosted alternative to Mailshake.

Documentation Setup guides Support Pricing Terms of Service Privacy Policy Sitemap

© 2026 SubsiMail.

We use Google Analytics to understand traffic to this site. It only runs if you accept -- see our Privacy Policy.