Add External ID Info for an Entity

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.

Response Parameters


id

  • Type: Integer
  • Description: The unique identifier assigned to this external ID record.

external_id

  • Type: String
  • Description: The external ID assigned by the integration partner.

integration_name

  • Type: String
  • Description: The name of the third-party integration that provided this external ID.

external_id_holder_id

  • Type: Integer
  • Description: The unique identifier assigned to the entity such as a user, vehicle, asset, or a group. If your entity is a user, then enter the user ID here. If a vehicle, enter the vehicle ID. Similarly for asset (asset ID), and group (group ID).

external_id_holder_type

  • Type: String
  • Description: Specify the type of the holder or the entity. Allowed values are User, Vehicle, Asset, or Group.

Language
Credentials
Header
Click Try It! to start a request and see the response here!