---
title: "Create connector"
method: POST
path: "/connectors"
---

# Create connector

`POST /connectors`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/connectors`
- Auth: HTTP bearer

Tenant-bound connector configuration. No provider requests. Credentials are masked. Mutations require the current revision where applicable. Referenced connections and nonempty connectors cannot be deleted. New custom connector and action creation requires workspace rollout enablement.

## Request body

- ConnectorInput
  - `name` string, required
  - `description` string

## Response `201`

Success

- ConnectorResponse
  - `connector` Connector, required
    - `connectorId` string, required
    - `tenantId` string
    - `kind` 'custom' | 'provider' | 'builtin' | 'legacy', required
    - `provider` string
    - `name` string, required
    - `description` string
    - `revision` integer
    - `createdAt` string
    - `updatedAt` string
    - `connectionCount` integer
    - `attentionCount` integer
    - `inventoryComplete` boolean
    - `actionFamily` 'http' | 'collection': Missing means http for existing custom connectors.
    - `hasActions` boolean: Built-in Visito group contains existing ungrouped collection actions.

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)