---
title: "Create a new integration connection for a given org"
method: POST
path: "/v1/core/integrations/connections"
---

# Create a new integration connection for a given org

`POST /v1/core/integrations/connections`

Create a new integration connection for a given org

## Request body

- object
  - `name` string, required — Name of the integration connection
  - `integrationPlatform` 'MERGE' | 'SIRO_CUSTOM_INPUT' | 'SERVICE_TITAN' | 'COMPANY_CAM' | 'INGAGE' | 'LEAD_PERFECTION' | 'SPOTIO', required — The type of integration connection
  - `externalAccountId` string, required — External account id (typically maps to a tenant)
  - `isActive` boolean — Whether the connection is active

## Response `201`

Create a new integration connection for a given org

- object
  - `id` string, required
  - `name` string, required
  - `externalAccountId` string, required
  - `organizationId` string, required
  - `integrationPlatform` 'MERGE' | 'SIRO_CUSTOM_INPUT' | 'SERVICE_TITAN' | 'COMPANY_CAM' | 'INGAGE' | 'LEAD_PERFECTION' | 'SPOTIO', required
  - `createdAt` string, required — ISO 8601 date string
  - `updatedAt` string, required — ISO 8601 date string
  - `isActive` boolean, required — Whether the integration is actively syncing data
  - `syncStatus` object[], required
    - `id` string, required
    - `modelName` string, required
    - `modelSyncStatus` 'SYNCING' | 'UP_TO_DATE' | 'ERROR', required
    - `modelModifiedAfter` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, nullable, required
  - `syncTranscript` boolean — Whether the transcript will be included in the sync payload

## Other responses

- `400` — Integration platform not supported
- `409` — Duplicate connection for integration platform for org

---

[API](https://skmtc.dev/siro/apis/swagger-api.md) · [All operations](https://skmtc.dev/siro/apis/swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siro/swagger-api/revisions/9995339a94c6/schema)