SubsiMail
Why self-host Pricing Docs Changelog Support FAQ Log in Get started
Log in Get started

← Back to Support

Getting 429 Too Many Requests on the campaigns API

#5 Resolved
Steven Y. 195 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 195 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. 195 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 195 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 TXT record limit — can I combine SPF and DKIM in one record?
Elizabeth H. 1 reply
Resolved Is my SMTP password stored securely?
Nancy H. 1 reply
Resolved Getting 'relay access denied' from my SMTP provider
Paul W. 1 reply
Resolved Which SMTP port should I use, 587 or 465?
Amanda P. 1 reply
In Progress Randomly logged out on mobile but not desktop
Barbara R. 2 replies

SubsiMail

The self-hosted alternative to Mailshake.

Documentation Setup guides Changelog Support 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.