Skip to main content
POST
/
v1
/
core
/
integrations
/
connections
Create a new integration connection for a given org
curl --request POST \
  --url https://functions.siro.ai/api-externalApi/v1/core/integrations/connections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "externalAccountId": "<string>",
  "isActive": true
}
'
{
  "id": "<string>",
  "name": "<string>",
  "externalAccountId": "<string>",
  "organizationId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "isActive": true,
  "syncStatus": [
    {
      "id": "<string>",
      "modelName": "<string>",
      "modelModifiedAfter": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "syncTranscript": true
}

Authorizations

​
Authorization
string
header
default:<organization-api-token>
required

Organization integration token from Siro admin (Person icon → API Tokens). Send Authorization: Bearer . This is not the OAuth access token used with api.siro.ai user-scoped endpoints.

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