System level guidelines

There are throttling limits in place when calling the API. Try to optimize the workflow of calls to the API to achieve the maximum work within the number of allowed calls.

Your calls may be blocked if they exceed the defined limits of your system or organization.

Dates and times will be in the organization time zone unless otherwise specified.

Use batches to update multiple users in one request instead of single-user updates in each call.

Do not exceed more than 1000 users in each call because the SyncBy endpoints are in real-time. If you need to synchronize more than 1000 users in a call, use the background job CSV import endpoint.

Don't store UserIDs inside your application. The identifier for the user is username or mapping ID.

The API GET method does not retrieve CommonName attributes when they contain the following special characters : + @ #

Common names may be optional in the user interface.