Skip to main content
POST
/
v1
/
organizations
/
{org_id}
/
users
curl -X POST https://api.teli.ai/v1/organizations/{org_id}/users \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith",
    "email": "john@example.com",
    "permission": "admin"
  }'

{
  "success": true,
  "user": {
    "unique_id": "1763072368418x263803518630956376",
    "name": "John Smith",
    "email": "john@example.com",
    "permission": "admin",
    "total_campaigns": 0,
    "total_agents": 0
  },
  "powered_by": "Teli"
}
Create a new user with specific permissions in an organization.
The same email address can exist in multiple organizations. Each organization gets its own user record with its own permissions. However, the same email cannot be added twice to the same organization.

​
Authorizations

​
X-API-Key
string
required
Authentication header containing your API key.

​
Path

​
org_id
string
required
Organization unique_id

​
Body

​
name
string
required
User’s full name
​
email
string
required
User’s email address. Must be unique within the organization. The same email can be used across different organizations.
​
phone
string
User’s phone number in E.164 format (e.g., +15551234567). Optional.
​
permission
string
Permission level: admin or user. Default: user
curl -X POST https://api.teli.ai/v1/organizations/{org_id}/users \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith",
    "email": "john@example.com",
    "permission": "admin"
  }'

{
  "success": true,
  "user": {
    "unique_id": "1763072368418x263803518630956376",
    "name": "John Smith",
    "email": "john@example.com",
    "permission": "admin",
    "total_campaigns": 0,
    "total_agents": 0
  },
  "powered_by": "Teli"
}

​
Response

​
unique_id
string
User identifier. Each user record gets a unique ID, even if the same email exists in another organization.
​
total_campaigns
number
Campaigns created by this user

​
Error Responses

400
{
  "error": "email is required"
}
404
{
  "error": "Organization not found"
}
500
{
  "error": "A user with email john@example.com already exists in this organization"
}
If a user with the same email already exists in the same organization, the request will be rejected. To add the same person to a different organization, simply create a new user with the same email in the other organization — a new unique_id will be generated.