Skip to main content
POST
/
v1
/
integrations
/
accounts
Create an account
curl --request POST \
  --url https://functions.siro.ai/api-externalApi/v1/integrations/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalId": "<string>",
  "latitude": 123,
  "longitude": 123,
  "name": "<string>",
  "phoneNumbers": [
    "<string>"
  ],
  "emailAddresses": [
    "<string>"
  ],
  "addresses": [
    {
      "country": "<string>",
      "street": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zip": "<string>"
    }
  ]
}
'
{
  "id": "<string>",
  "externalId": "<string>",
  "addresses": [
    null
  ],
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "latitude": 123,
  "longitude": 123,
  "phoneNumbers": [
    "<string>"
  ],
  "emailAddresses": [
    "<string>"
  ],
  "name": "<string>"
}

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
​
externalId
string
required

The ID of the account in the external system (e.g. Salesforce)

​
latitude
number
required
​
longitude
number
required
​
name
string
​
phoneNumbers
string[]
​
emailAddresses
string[]
​
addresses
object[]

Response

200 - application/json

Create an account

​
id
string
required
​
externalId
string
required

The ID of the account in the external system (e.g. Salesforce)

​
addresses
null[]
required
​
createdAt
string
required

The date the account was created

​
updatedAt
string
required

The date the account was last updated

​
latitude
number
​
longitude
number
​
phoneNumbers
string[]
​
emailAddresses
string[]
​
name
string