Skip to main content
POST
/
v1
/
contacts
/
groups
curl -X POST https://api.teli.ai/v1/contacts/groups \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "organization_id": "{org_id}",
    "user_id": "{user_id}",
    "group_name": "November Leads"
  }'

{
  "success": true,
  "group_id": "1763072372500x777103986713560785",
  "group_name": "November Leads",
  "message": "Contact group created successfully",
  "powered_by": "Teli"
}

​
Description

Create a new contact group (folder) to organize contacts. This is the first step - all contacts must belong to a group. Group names must be unique within an organization (case-insensitive: “Test” and “test” are considered the same name). Groups can be used to:
  • Organize leads from different sources
  • Segment contacts for campaigns
  • Track contacts by status or category
After creating a group, add contacts using:

​
Authorizations

​
X-API-Key
string
required
Authentication header

​
Request Body

​
organization_id
string
required
Organization unique_id
​
user_id
string
required
User unique_id (who is creating the group)
​
group_name
string
required
Name for the contact group
​
description
string
Optional description of the group
curl -X POST https://api.teli.ai/v1/contacts/groups \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "organization_id": "{org_id}",
    "user_id": "{user_id}",
    "group_name": "November Leads"
  }'

{
  "success": true,
  "group_id": "1763072372500x777103986713560785",
  "group_name": "November Leads",
  "message": "Contact group created successfully",
  "powered_by": "Teli"
}