SubsiMail
Why self-host Live demo Pricing Docs Blog Download Changelog Support FAQ Log in Book a meeting Free report
Log in Book a meeting Free report

← Back to Support

Ask AI about this ticket

Getting 429 Too Many Requests on the campaigns API

#5 Resolved
Steven Y. 240 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 240 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. 240 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 240 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

Resolved Can I trigger a campaign from a Google Sheet automatically?
Samuel W. 1 reply
Resolved Zapier trigger isn't firing when a contact replies
Ashley D. 2 replies
Resolved How do I fetch reply/bounce status for a specific contact via API?
William C. 1 reply
Resolved Scheduled campaign sent at the wrong time — timezone issue?
Jason J. 1 reply
Resolved Attachments over a certain size fail to send
David B. 1 reply

SubsiMail

The self-hosted alternative to Mailshake.

Questions? support@subsimail.com

Documentation Setup guides Blog Download Changelog Support Email us Book a 30-min meeting Pricing Affiliates Terms of Service Privacy Policy Sitemap

Compare

vs. Instantly vs. Smartlead vs. lemlist vs. Apollo

Solutions

For agencies For recruiters

© 2026 SubsiMail.

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