added
New endpoints for managing external Ids
May 22nd, 2025 by Abhay Anumula
With this release, we have introduced 3 new endpoints that will allow businesses to add, update, and delete information pertaining to external integrations with entities such as Users, Vehicles, Assets, and Groups.
New Endpoints
- Name: Add external id info for an entity
- Method: POST
- URL: https://api.gomotive.com/v1/external_ids
- Purpose: Use this endpoint to add the external integration details of an entity. For example, if you have an existing ADP integration for running the payroll of your users, this endpoint allows you to add critical info such as the integration name, and external Id, for mapping your users between ADP and Motive. This provides for a seamless integration between the two systems.
- Name: Update the external id of an entity
- Method: PUT
- URL: https://api.gomotive.com/v1/external_ids/{id}
- Purpose: Use this endpoint to update the external integration info of an entity.
NOTE: Requires you to provide the unique identifier assigned to the external ID.
- Name: Delete an external id for an entity
- Method: DEL
- URL: https://api.gomotive.com/v1/external_ids/{id}
- Purpose: Use this endpoint to delete the external integration ID for an entity. For example, if you were earlier using a third-party integration for managing your users, and no longer require it, you can go ahead and call this endpoint to remove the association of your users with the third-party software inside Motive.
NOTE
Apart from the three new endpoints (POST, PUT, and DELETE for external_ids), the changes affect existing endpoints that use the external_id. Specifically, users, vehicles, assets, and groups endpoints as the logic now allows for updating an existing external_id. The documentation for these endpoints is also updated with respect to this change.