Is there a way to bulk create/update users via API?

  • 16 July 2021
  • 7 replies

I have an application with a few thousand users that I would like to create/update in intercom and synchronise at least weekly with attributes that are calculated by my backend and that are required for contextual engagement.


The Contacts API does not support bulk updates and has two major constraints for large volume: i) it requires your app to understand whether a contact has already been created before calling with POST or PUT (the javascript SDK does not suffer from this); ii) the API rate limits are ridiculously small for any medium-sized user base (166 requests per 10s window, what???), which are even smaller if you need to check if a user exists before issuing either a POST or PUT.


Furthermore, the Contacts API requires you to save the intercom id for a user for any updates, which is not user-friendly at all. The javascript SDK operates from the external_id provided (controlled by my app), while the REST API does not understand it at all and requires you to either call a GET or save the intercom id in the database. Yes, RESTful, but very bad design.


And, the manual import requires that all attributes being imported to be manually mapped by the user, a major time drag and extremely error prone.


So, are there any better options to enable bulk create/update of "user" contacts?


Best answer by Diana Tripac 15 June 2022, 12:22

View original

7 replies

Userlevel 1

Hey @roy s11​, I know you're very knowledgable when it comes to our API. Do you think you would be able to help @eduardo g11​ here?

Hello, same for me ! An answer ?

@eric f11​ @eduardo g11​ any updates here? Thanks

Userlevel 3
Badge +2

Hi Eduardo!👋 We don't have an endpoint for bulk updating users I'm afraid.

Hi @Diana Tripac ,

Since you last answer is a year old . Just wanted to check if there have been any change on this topic or at least is it in the dev teams roadmap for the current year? Thanks.

+1 here. 


Has anyone found a work around? I am in disbelief there is no solution for this… it is Intercom for crying out loud. 

Userlevel 4
Badge +5

Hey there! 

There currently isn’t a way to bulk create Contacts via the API, but you should be able to write a script that loops through an Array and creates those Users using our APIs ‘Create Contact’ endpoint

You can bulk create Users via a CSV import in your Workspace if that’s preferable. You can read up on that process here.