---
title: "Create a custom API connector"
method: POST
path: "/external/v1/connectors"
tags: ["Connector"]
---

# Create a custom API connector

`POST /external/v1/connectors`

## Request

- Base URL: `https://api.databar.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.databar.ai/external/v1/connectors`
- Auth: API key in header `x-apikey`

## Request body

- ConnectorCreate
  - `name` string, required: Display name for the connector
  - `type` string: Connector type: simple, enrichment, or exporter
  - `method` string, required: HTTP method: get, post, put, or patch
  - `url` string, required: Full API endpoint URL
  - `headers` NameValue[]
    - `name` string, required
    - `value` string
  - `parameters` NameValue[]
    - `name` string, required
    - `value` string
  - `body` NameValue[]
    - `name` string, required
    - `value` string
  - `body_template` string, nullable: Jinja body template.
  - `rate_limit` integer, nullable
  - `max_concurrency` integer, nullable

## Response `200`

OK

- ConnectorOut
  - `id` integer, required
  - `name` string, required
  - `type` string, required
  - `method` string, required
  - `url` string, required
  - `headers` NameValue[]
    - `name` string, required
    - `value` string
  - `parameters` NameValue[]
    - `name` string, required
    - `value` string
  - `body` NameValue[]
    - `name` string, required
    - `value` string
  - `body_template` string, nullable
  - `rate_limit` integer, nullable
  - `max_concurrency` integer, nullable
  - `created_at` string, nullable

---

[API](https://skmtc.dev/databar/apis/external-api.md) - [All operations](https://skmtc.dev/databar/apis/external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/databar/apis/external-api/revisions/efe15f8bb9bb?raw)