---
title: "Create connector connection"
method: POST
path: "/connectors/{connectorId}/connections"
---

# Create connector connection

`POST /connectors/{connectorId}/connections`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/connectors/{connectorId}/connections`
- 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.

## Path parameters

- `connectorId` string, required

## Request body

- ConnectorConnectionInput
  - `name` string, required
  - `baseUrl` string, required
  - `enabled` boolean
  - `auth` ToolAuthInput, required
    - `type` 'none' | 'bearer' | 'api_key', required
    - `headerName` string
    - `value` string

## Response `201`

Success

- ConnectorConnectionResponse
  - `connection` ConnectorConnection, required
    - `connectorId` string
    - `tenantId` string
    - `connectionId` string
    - `integrationId` string
    - `name` string
    - `displayName` string
    - `accountEmail` string, nullable
    - `propertyId` string
    - `baseUrl` string
    - `enabled` boolean
    - `active` boolean
    - `degraded` boolean
    - `status` string
    - `revision` integer
    - `version` integer
    - `createdAt` string
    - `updatedAt` string
    - `auth` object
      - `type` 'none' | 'bearer' | 'api_key', required
      - `headerName` string
      - `secretLastFour` string
      - `configured` boolean, required

---

[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)