Skip to main content
POST
/
api
/
v1
/
teams
Create Team
curl --request POST \
  --url http://localhost:8080/api/v1/teams \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Support",
  "emoji": "😗",
  "conversation_assignment_type": "Manual",
  "max_auto_assigned_conversations": 2,
  "timezone": "America/Toronto",
  "business_hours_id": 1,
  "sla_policy_id": 1
}'
{
  "status": "success",
  "data": {
    "id": 1,
    "created_at": "2025-08-28T10:00:00Z",
    "updated_at": "2025-08-28T10:00:00Z",
    "emoji": "🛠️",
    "name": "Support Team",
    "conversation_assignment_type": "round_robin",
    "timezone": "UTC",
    "business_hours_id": 1,
    "sla_policy_id": 1,
    "max_auto_assigned_conversations": 10
  }
}

Authorizations

​
Authorization
string
header
required

Basic authentication using base64 encoded API key and secret. Format: Authorization: Basic <base64(api_key:api_secret)>

Body

application/json

Team configuration

​
name
string
Example:

"Support"

​
emoji
string
Example:

"😗"

​
conversation_assignment_type
string
Example:

"Manual"

​
max_auto_assigned_conversations
integer
Example:

2

​
timezone
string
Example:

"America/Toronto"

​
business_hours_id
integer
Example:

1

​
sla_policy_id
integer
Example:

1

Response

Created team

​
status
string
Example:

"success"

​
data
object
⌘I