Skip to main content
POST
/
api
/
organizations
Create a new organization
curl --request POST \
  --url https://your-instance.example.com/api/organizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Corp",
  "phoneNumber": "+14165550100",
  "address": "123 Yonge St, Toronto, ON",
  "adminDetails": {
    "email": "admin@acme.example",
    "password": "CorrectHorseBatteryStaple9!",
    "fullName": "Alex Admin"
  }
}
'
{
  "message": "Organization with admin user created successfully",
  "data": {
    "_id": "5f7b1c2e8a1d4e0012c3b400",
    "name": "Acme Corp",
    "phoneNumber": "+14165550100"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required

Organization display name shown across UI and templates.

​
phoneNumber
string
required

Primary organization phone number in E.164 format (must start with +1 or +91 followed by 10 digits).

​
adminDetails
object
required

Initial admin user created alongside the organization; email and password seed the first login.

Example:
{
  "email": "admin@acme.example",
  "password": "CorrectHorseBatteryStaple9!",
  "fullName": "Alex Admin",
  "phoneNumber": "+14165550100",
  "designation": "Operations Lead",
  "sinchPhoneNumber": "+14165550101"
}
​
address
string

Mailing/business address for the organization.

​
creds
object

Optional third-party API credentials (Anthropic, Sinch SMS/MMS) provisioned for the new organization.

Example:
{
  "anthropicApiKey": "sk-ant-api03-EXAMPLE-key-redacted",
  "sinchServicePlanId": "srv-plan-example-123",
  "sinchApiToken": "sinch-token-example-redacted",
  "sinchMmsApiKey": "sinch-mms-key-example",
  "sinchMmsServiceId": "sinch-mms-service-example"
}

Response

Organization created

​
message
string
​
data
object