Create a team member

Adds a new user to the workspace.

• If password is provided, the member can log in immediately.
• If password is omitted, an invitation email is sent and the member's status is INVITED until they accept.
• The workspace must have an available license seat — otherwise 402 BUY_LICENSE.

Request

Field	Value
Method	POST
URL	https://next.telecrm.in/autoupdate/v2/enterprise/{enterpriseId}/team-members
Auth	Bearer token (Sync-typed). See Authentication.
Headers	Content-Type: application/json

Path parameters

Name	Type	Required	Description
enterpriseId	string	yes	The enterprise (workspace) ID.

Body

Field	Type	Required	Description
name	string	yes	Full name.
email	string	yes	Email address — also used as the login identifier.
phone_number	string	yes	Phone number with country code (no spaces, no +). Format: 919876543210.
role	string	yes	One of ADMIN, MANAGER, CALLER, MARKETING_USER.
password	string	no	If supplied, the member can log in immediately. If omitted, an invitation email is sent and the member starts in INVITED.

Example request

curl -X POST "https://next.telecrm.in/autoupdate/v2/enterprise/{enterpriseId}/team-members" \
  -H "Authorization: Bearer YOUR_SYNC_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone_number": "919876543210",
    "role": "CALLER"
  }'

Responses

201 Created

{
  "name": "John Doe",
  "email": "john.doe@example.com",
  "phone_number": "919876543210",
  "role": "CALLER",
  "status": "INVITED"
}

status is INVITED if no password was provided; otherwise Active.

400 Bad Request

One or more fields failed validation. The response includes a details array with per-field messages.

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Validation failed",
    "details": [
      { "field": "role", "message": "Invalid role. Allowed roles: ADMIN, MANAGER, CALLER, MARKETING_USER" }
    ]
  }
}

401 Unauthorized

See the universal 401 in the overview.

402 Payment Required

License seat limit reached.

{
  "error": {
    "code": "BUY_LICENSE",
    "message": "License seat limit reached"
  }
}

403 Forbidden

The token does not have permission to create team members.

{
  "error": {
    "code": "NOT_AUTHORIZED",
    "message": "Not authorized"
  }
}

Notes

• Email is the primary identifier — duplicates are rejected.
• Phone number must include country code without symbols. 919876543210, not +91 98765 43210.
• Newly created members start with no permission template assigned beyond their role's default. Adjust permissions in the dashboard if needed.