Customer data - import using APIs

Use this endpoint to create a new customer or update an existing customer.

• The call happens synchronously and you get immediate feedback on any processing errors.
• Make parallel calls to get high throughput. The throughput is less when compared to bulk event API calls.
• Implement error handling when using the API.
• We recommend that you limit the calls to this endpoint to 50 per second.

Use this endpoint to create or update details of multiple customers.

• The bulk call happens synchronously and you get immediate feedback on any processing errors.
• The throughput is better than create customer API but you must iterate through the response to check for processing errors.
• Implement error handling when using the API.
• The maximum number of users is limited to 50/call. We recommend that you limit the number of bulk calls to 5 calls/sec (or 250 users/second).

Set the event = identify in these APIs to create or update customer data.

• You can get high throughputs with bulk events, but the processing happens asynchronously, so you are not notified of any errors.
• All the errors are captured and shown in the Click-stream tracking page as "Processing Errors".
• The maximum size of a payload is 1MB or 100 events per payload.
• Multiple bulk events may be sent as part of an array. We recommend you limit the number of bulk calls to 5 per second (500 events/sec).