---
title: "Create a new connector"
method: POST
path: "/v1/data_sources/{data_source_id}/connectors"
tags: ["data_sources", "data_sources"]
---

# Create a new connector

`POST /v1/data_sources/{data_source_id}/connectors`

Create a new connector.

Args:
    data_source_id: The ID of the data source to create a connector for.
    params: The connector to create.

Returns:
    The created connector.

## Path parameters

- `data_source_id` string, uuid, required — The ID of the data source to create a connector for

## Request body

- DataSourceConnectorCreateParams — Parameters for creating a connector.
  - `store_id` string, required — The ID of the store
  - `name` string — The name of the connector
  - `trigger_sync` boolean — Whether the connector should be synced after creation
  - `metadata` unknown
  - `polling_interval` union — Polling interval for the connector. Defaults to 30 minutes if not specified. Can be provided as: - int: Number of seconds (e.g., 1800 for 30 minutes) - str: Duration string (e.g., '30m', '1h', '2d') or ISO 8601 format (e.g., 'PT30M', 'P1D') Valid range: 15 seconds to 30 days
    - integer
    - string

## Response `201`

The created connector

- DataSourceConnector — Service-level representation of a connector.
  - `id` string, required — The ID of the connector
  - `created_at` string, date-time, required — The creation time of the connector
  - `updated_at` string, date-time, required — The last update time of the connector
  - `store_id` string, required — The ID of the store
  - `data_source_id` string, required — The ID of the data source
  - `name` string — The name of the connector
  - `metadata` unknown, required
  - `polling_interval` string, duration, required — The polling interval of the connector
  - `started_at` string, date-time, nullable, required — The start time of the connector
  - `finished_at` string, date-time, nullable, required — The finish time of the connector
  - `last_synced_at` string, date-time, nullable, required — The last sync time of the connector
  - `status` 'idle' | 'pending' | 'in_progress' | 'cancelled' | 'completed' | 'failed', required
  - `error` object, nullable, required — The sync error of the connector
  - `object` 'data_source.connector' — The type of the object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.dev/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/revisions/79d5edfa05e3/schema)