---
title: "Create connector"
method: POST
path: "/connection/connectors"
tags: ["Connection - Connectors"]
---

# Create connector

`POST /connection/connectors`

Create a new connector

## Request body

- object — Request body schema.
  - `name` string, required — Connector name.
  - `slug` string, required — Connector slug.
  - `integrationSlug` string, required — Integration identifier.
  - `config` object — Connector configuration.
  - `rateLimit` object — Rate limit configuration.
    - `unit` 'day' | 'hour' | 'minute' | 'second', required — Rate limit time unit.
    - `max` number, required — Maximum requests per unit.
    - `strategy` 'spread' | 'burst', required — Rate limit strategy: spread requests evenly or allow burst then wait.
  - `cacheTtlMilliseconds` number — Cache time-to-live in milliseconds.

## Response `200`

Successful response

- object
  - `connector` union, required
    - object — Connector details.
      - `uuid` string, required
      - `workspaceUuid` string, required
      - `userUuid` string, required
      - `name` string, required
      - `slug` string, required
      - `rateLimit` object, nullable, required
        - `unit` 'day' | 'hour' | 'minute' | 'second', required
        - `max` number, required
      - `cacheTtlMilliseconds` number, nullable, required
      - `integrationSlug` string, required
      - `isDefault` boolean, required
      - `playsCount` number, required
      - `toolsCount` number, required
      - `modelsCount` number, required
      - `createdAt` string, required
      - `updatedAt` string, required
      - `deletedAt` string, nullable, required
      - `useCredits` true, required
      - `config` unknown, required
    - object — Connector details.
      - `uuid` string, required
      - `workspaceUuid` string, required
      - `userUuid` string, required
      - `name` string, required
      - `slug` string, required
      - `rateLimit` object, nullable, required
        - `unit` 'day' | 'hour' | 'minute' | 'second', required
        - `max` number, required
      - `cacheTtlMilliseconds` number, nullable, required
      - `integrationSlug` string, required
      - `isDefault` boolean, required
      - `playsCount` number, required
      - `toolsCount` number, required
      - `modelsCount` number, required
      - `createdAt` string, required
      - `updatedAt` string, required
      - `deletedAt` string, nullable, required
      - `useCredits` false, required
      - `config` object, required
  - `dataset` union, required
    - object — Created dataset details.
      - `uuid` string, required
      - `workspaceUuid` string, required
      - `slug` string, required
      - `createdAt` string, required
      - `updatedAt` string, required
      - `deletedAt` string, nullable, required
      - `kind` 'connector', required
      - `connectorUuid` string, required
    - object — Created dataset details.
      - `uuid` string, required
      - `workspaceUuid` string, required
      - `slug` string, required
      - `createdAt` string, required
      - `updatedAt` string, required
      - `deletedAt` string, nullable, required
      - `kind` 'native', required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/getcargo/apis/cargo-api.md) · [All operations](https://skmtc.net/getcargo/apis/cargo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getcargo/cargo-api/revisions/1d5a19e01d83/schema)