Rate limits
Request limits across the PeopleForce API and how to recover from a 429.
The PeopleForce API applies a rate limit to all endpoints to prevent misuse, protect the platform, and handle incoming volume. The limit is calculated per minute and enforced per API key (it falls back to the requesting IP address when a request carries no API key).
The current limit is 300 requests per minute.
Recovering from a rate limit
When you exceed the limit, the endpoint returns HTTP 429 Too Many Requests.
On a 429, slow down your request rate and wait before retrying.
Check the Retry-After response header to learn when the limit resets — its
value is the number of seconds remaining until the limit is cleared. A good
practice is to read that header and pause your requests for that many seconds
before trying again.