# Register or update a tracking device

Registers a new or updates an existing tracking device depending if the device is already known. A device is defined by a unique combination of the externalSystemId and the externalDeviceId. So registering an already existing device will update all the attributes except the DeviceUUID

Endpoint: POST /
Version: 2.0
Security: BearerAuth

## Request fields (application/json):

  - `externalDeviceId` (string, required)
    The identifier you use to recognize the device/vehicle in your source system

  - `externalSystemId` (string, required)
    Identifier for the source system we use to uniquely recognize the shipper/carrier

  - `active` (boolean, required)
    Indicates whether the current tracking device is active or not

  - `carrierCode` (string, required)
    This code is used by the Simacan Control Tower to match a Tracking Device with a carrier

  - `customerDeviceId` (string, required)

  - `licensePlate` (string)
    License Plate linked with the current tracking device

  - `driverName` (string)
    Driver name linked with the current tracking device

  - `attributes` (object)
    Any freeform additional attributes

## Response 200 fields (application/json):

  - `deviceUUID` (string)
    This is the Simacan generated universally unique identifier
    Example: "b9ed42ff-3ffb-4418-9498-5eb0ba308899"

  - `externalSystemId` (string)
    Identifier for the source system we use to uniquely recognize the shipper/carrier
    Example: "fms-janszoon_transport"

  - `externalDeviceId` (string)
    The identifier you use to recognize the device/vehicle in your source system
    Example: "1234"

  - `customerDeviceId` (string)

  - `active` (boolean)
    Indicates whether the current tracking device is active or not
    Example: "true"

  - `relation` (string)
    Example: "janszoon_transport"

  - `carrierCode` (string)
    This code is used by the Simacan Control Tower to match a Tracking Device with a carrier

  - `creationDate` (string)
    Timestamp when record was created
    Example: "2020-06-07T09:17:43Z"

  - `lastUpdatedDate` (string)
    Timestamp when record was updated

  - `licensePlate` (string)
    License Plate linked with the current tracking device
    Example: "AB-12-CD"

  - `driverName` (string)
    Driver name linked with the current tracking device

  - `attributes` (object)
    Any freeform additional attributes
    Example: {"carBrand":"Mercedes"}