Add new project

This endpoint creates a new project and assigns it to a customer's configuration.

HTTPS method: POST

URL format

For ease of viewing and identification:

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

https://baseURL/geofencing/versionNumber/projects/project?key=Your_API_Key&adminKey=Your_Admin_Key

curl command

curl -v -XPOST -H "Content-type: application/json" -d 
'{
   "name": "a_project_name"
 }'
'https://baseURL/geofencing/versionNumber/projects/project?key=Your_API_Key&adminKey=Your_Admin_Key'

POST Request body

{
  "name": "a_project_name"
}

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.

{
  "name": "a_project_name",
  "id": "a_project_id"
}

Response fields

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

HTTP Response codes

Request format

https://api.tomtom.com/geofencing/1/projects/project?key=Your_API_Key&adminKey=Your_Admin_Key

POST Request body

{
  "name": "Airports in Germany"
}

Response body

{
  "name": "Airports in Germany",
  "id": "44de824d-c368-46cf-a234-a6792682dfd6"
}