Skip to main content
POST
/
v1
/
core
/
users
Create user
curl --request POST \
  --url https://functions.siro.ai/api-externalApi/v1/core/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "organizationId": "<string>",
  "password": "<string>",
  "phoneNumber": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "memberTeamId": "<string>",
  "externalId": "<string>",
  "coachTeamIds": [
    "<string>"
  ],
  "isAdmin": true,
  "billable": true,
  "contactSettings": {
    "suppressEmails": true,
    "suppressEmailErrors": false
  }
}
'
{
  "id": "<string>",
  "email": "<string>",
  "organizationId": "<string>",
  "phoneNumber": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "memberTeamId": "<string>",
  "coachTeamIds": [
    "<string>"
  ],
  "externalId": "<string>",
  "createdAt": "<string>",
  "disabled": true,
  "billable": true,
  "contactSettings": {
    "suppressEmails": true,
    "suppressEmailErrors": false
  }
}

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

The email of the user in your system. They will receive a password reset email to this address when their user is created in Siro.

​
organizationId
string
required
​
password
string

Deprecated. This field is ignored; the backend generates a secure random password for the account.

​
phoneNumber
string

The user's phone number.

​
firstName
string

The user's first name.

​
lastName
string

The user's last name.

​
memberTeamId
string

The 6 digit code for the user's team. Strongly suggested to add this.

​
externalId
string

The unique id of the resource in your CRM system. Multiple resources cannot have the same externalId within the same organization.

​
coachTeamIds
string[]
​
isAdmin
boolean
​
billable
boolean

Whether the user is billable and should be included in the license count

​
contactSettings
object

Contact settings for the user

Response

200 - application/json

Create user

​
id
string
required
​
email
string | null
required
​
organizationId
string
required
​
phoneNumber
string | null
required
​
firstName
string | null
required
​
lastName
string | null
required
​
memberTeamId
string | null
required
​
coachTeamIds
string[]
required
​
externalId
string | null
required
​
createdAt
string | null
required
​
disabled
boolean
required
​
billable
boolean
required
​
contactSettings
object

Contact settings for the user