---
title: "Creates a connector"
method: POST
path: "/c2c/v4/connectors"
tags: ["C2C"]
---

# Creates a connector

`POST /c2c/v4/connectors`

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.

## Request body

- object
  - `description` string — Brief description of the connector.
  - `driverId` string, required — Identifier of the driver to be used with this connector.
  - `enabled` boolean, required — Enabled state of the connector. If set to false then the connector will not execute periodically.
  - `externalCloudInfo` object, 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.
  - `name` string, required — Name of the connector.
  - `refreshIntervalS` integer — 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.

## Response `200`

Successful

- object — Identifier of the connector.

## Other responses

- `400` — Bad request The request object is in an incorrect format or has values that are invalid or out of range. If available, further error details are provided in the response body.
- `401` — Unauthorized The request did not provide correct authentication details
- `403` — Forbidden The account does not have the correct privileges
- `404` — Not Found The specified resource was not found
- `409` — Conflict The specified resource already exists

---

[API](https://skmtc.net/here/apis/tracking.md) · [All operations](https://skmtc.net/here/apis/tracking/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/here/tracking/revisions/efa162f7023c/schema)