Register Admin Key

This endpoint is used to register a customer.

• Before a customer can use the service, or act as an Admin for Location History endpoints, they must register.
• Registering creates a configuration for the customer and creates an Admin Key, used to create/edit/delete Location History data.

HTTPS method: POST

URL format

For ease of viewing and identification:

• Required constants and parameters are shown in bold text.
• Optional parameters are shown in plain text.

https://baseURL/locationHistory/versionNumber/register?key=Your_API_Key

curl command

curl -XPOST "Content-type: application/json" -d
'{
   "secret": "your_secret"
 }'
'https://baseURL/locationHistory/versionNumber/register?key=Your_API_Key'

POST request body

{
  "secret": "secret_key"
}

Request parameters

The following table describes the parameters that can be used in a request.

• Required parameters must be used or the call will fail.
• Optional parameters may be used.
• If there is a default value that will be assumed when an optional parameter is not used, it is shown in the table.
• The order of request parameters is not important.

Response body

The following JSON code block demonstrates a successful response from the API server.

{
  "adminKey": "admin_key"
}

Response fields

The following table describes all of the fields that can appear in a response.

HTTP response codes

Example: Register a customer account using a passed secret value.

HTML Method: POST

https://api.tomtom.com/locationHistory/1/register?key=Your_API_Key

POST request body (JSON)

{
  "secret": "My very secret secret"
}

Response body

{
  "adminKey": "UpP9m2jg4PU6fWAFnvskU33CwfW24e17P0oTC5byUfUzMElS"
}