Skip to main content
POST
Create a new integration connection for a given org

Authorizations

Authorization
string
header
default:Bearer <access-token>
required

Client app access token from POST https://auth.siro.ai/oauth2/token, or a legacy organization API token (Person icon → API Tokens). Send Authorization: Bearer <token>.

Body

application/json
name
string
required

Name of the integration connection

integrationPlatform
enum<string>
required

The type of integration connection

Available options:
MERGE,
SIRO_CUSTOM_INPUT,
SERVICE_TITAN,
COMPANY_CAM,
INGAGE,
LEAD_PERFECTION,
SPOTIO
externalAccountId
string
required

External account id (typically maps to a tenant)

isActive
boolean
default:true

Whether the connection is active

Response

Create a new integration connection for a given org

id
string
required
name
string
required
externalAccountId
string
required
organizationId
string
required
integrationPlatform
enum<string>
required
Available options:
MERGE,
SIRO_CUSTOM_INPUT,
SERVICE_TITAN,
COMPANY_CAM,
INGAGE,
LEAD_PERFECTION,
SPOTIO
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
syncTranscript
boolean

Whether the transcript will be included in the sync payload