---
title: "Create connector target"
method: POST
path: "/v1/connector-instances/{connectorInstanceId}/targets"
tags: ["Connectors"]
---

# Create connector target

`POST /v1/connector-instances/{connectorInstanceId}/targets`

Creates a connector target under a connector instance.

## Path parameters

- `connectorInstanceId` string, typeid, required

## Request body

- object
  - `connectorType` 'github', required
  - `remoteId` string, required
  - `targetKind` 'repository_branch', required
  - `externalTargetRef` string, nullable
  - `config` object, required

## Response `201`

Connector target created successfully.

- PluginArchConnectorTargetMutationResponse
  - `ok` true, required
  - `item` PluginArchConnectorTarget, required
    - `id` string, typeid, required — Den TypeID with 'ctg_' prefix and a 26-character base32 suffix.
    - `connectorInstanceId` string, typeid, required — Den TypeID with 'cin_' prefix and a 26-character base32 suffix.
    - `connectorType` 'github', required
    - `remoteId` string, required
    - `targetKind` 'repository_branch', required
    - `externalTargetRef` string, nullable, required
    - `targetConfigJson` object, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `400` — The connector target creation request was invalid.
- `401` — The caller must be signed in to create connector targets.
- `403` — The caller lacks permission to edit this connector instance.
- `404` — The connector instance could not be found.

---

[API](https://skmtc.net/openworklabs/apis/den-api.md) · [All operations](https://skmtc.net/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openworklabs/den-api/versions/805150503452/schema)