Synchronizing Users with JumpCloud: Handling Deleted and Updated Users Post-Integration

[kumararaja]

I'm currently working on integrating JumpCloud with my application to enable seamless user synchronization between the two systems. So far, I’ve been able to retrieve deleted users by leveraging the /insights/directory/v1/events API. Here's a sample of the API call I’m using:

curl --location 'https://api.jumpcloud.com/insights/directory/v1/events' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <API_KEY>' \
--data '{
  "service": ["directory"],
  "start_time": "2025-04-02T14:37:00Z",
  "filter": {
    "event_type": "user_deleted"
  }
}'

Once I detect a user_deleted event, I remove that user from my system accordingly. While this works, I’m wondering: Is this the only recommended way to track deletions, or are there alternative methods for detecting when a user has been deleted from JumpCloud? If anyone has suggestions or best practices, I’d love to hear them.

Additionally, after the initial sync, I’ve been filtering users created after a specific timestamp using the /systemusers endpoint like this:

curl --location 'https://console.jumpcloud.com/api/systemusers?limit=10&skip=0&sort=&fields=&filter=created%3A%24gt%3A2025-04-06' \
--header 'x-api-key: <API_KEY>'

This works well for tracking new users. But now, I'm looking for a way to identify users who have been updated (not just newly created) since a specific point in time. Is there any API or filter option available that can help retrieve recently updated users from JumpCloud?

If you’ve worked on a similar integration or know of a more efficient approach, I’d greatly appreciate your insights!

[trevorjc]

hey there,

typically SCIM would be used for this purpose. JumpCloud supports both inbound SCIM server and outbound SCIM client scenarios. if im understanding your case correctly, the outbound SCIM client is applicable here. this would require that your application support the SCIM spec. if your app supports this, you can create a custom integration in your JumpCloud org. this will enable JumpCloud to push all user updates, creations, etc. to your application for associated users

if you dont support SCIM, "listening" for Directory Insights events (as you mention in your post with user_deleted for example) is probably a good option. you would need to poll the Directory Insights API on a recurring basis to check for creations, deletions, updates, etc. all of which have specific events in Directory Insights