---
title: "POST /connectors"
method: POST
path: "/connectors"
tags: ["connectors"]
---

# POST /connectors

`POST /connectors`

## Request body

- CreateConnectorRequest
  - `description` string, nullable
  - `known_connector_type` string, required
  - `name` string, required
  - `nango_connection_id` string, nullable — Nango connection ID for OAuth token management
  - `nango_integration_id` string, nullable — Nango integration ID (e.g., "linear", "slack")
  - `pipedream_account_id` string, nullable
  - `pipedream_external_id` string, uuid, nullable — Unique external ID for Pipedream routing (required for Pipedream connectors)
  - `pipedream_project_id` string, nullable
  - `refresh_script` string, nullable
  - `secrets` object — Optional secrets/environment variables for the connector
  - `team_id` string, uuid, required

## Response `201`

Connector created successfully

- Connector
  - `connector_category` 'RelationalDatabase' | 'ApiTabular'
  - `created_at` string, date-time, required
  - `datahub_urn` string, nullable
  - `deleted_at` string, date-time, nullable
  - `description` string, nullable
  - `exploration_error` string, nullable
  - `exploration_started_at` string, date-time, nullable
  - `exploration_status` 'NotStarted' | 'Running' | 'Completed' | 'Failed', required
  - `id` string, uuid, required
  - `known_connector_type` string, required
  - `name` string, required
  - `nango_connection_id` string, nullable
  - `nango_integration_id` string, nullable
  - `pipedream_account_id` string, nullable
  - `pipedream_external_id` string, uuid, nullable
  - `refresh_script` string, nullable
  - `team_id` string, uuid, required
  - `updated_at` string, date-time, required
  - `usage_snippet_override` string, nullable

## Other responses

- `400` — Invalid request data
- `401` — Unauthorized
- `403` — Forbidden - user does not have access to team
- `500` — Internal server error

---

[API](https://skmtc.net/structifyai/apis/structify.md) · [All operations](https://skmtc.net/structifyai/apis/structify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/structifyai/structify/versions/1364930b6980/schema)