Sign in

v1

latestOpenAPI 3.0.0HERE Documentation License2026-07-142162791.8 MB
C2C

Creates a connector

Registers a cloud-to-cloud connector between the HERE Tracking project projectId and an external cloud using the cloud-to-cloud driver driverId and the external cloud access credentials.

post/c2c/v4/connectors

Request body

descriptionstring

Brief description of the connector.

driverIdstring required

Identifier of the driver to be used with this connector.

enabledboolean required

Enabled state of the connector. If set to false then the connector will not execute periodically.

externalCloudInfoobject required

An external cloud-specific object that the driver will use to login to the external cloud. The structure of this object varies per driver implementation. It is recommended to have dedicated credentials for logging in to the external cloud in order not to violate possible concurrent users policies of the external cloud. In case of the HERE Tracking loopback driver, the maximum allowed concurrent user account tokens is 3 per account, therefore it is recommended to create a separate HERE account and grant it the required privilege to update the connector's project, and use that account in externalCloudInfo.

namestring required

Name of the connector.

refreshIntervalSinteger

This is the interval (in seconds) to execute the sync process between the connector's external cloud and HERE Tracking project. The maximum and at the same time default value for callback-type connectors is 900 seconds. The default value for other type of connectors is 3600 seconds and there is no maximum value set.

Example request

{
  "driverId": "my-driver-1-id",
  "enabled": true,
  "externalCloudInfo": {
    "extAppId": "ext-app-id",
    "extUserId": "ext-user-id",
    "extUserPassword": "ext-user-password"
  },
  "name": "driver-name",
  "refreshIntervalS": 3600
}

Response

Successful

object required

Identifier of the connector.