Skip to main content
POST
/
v1
/
contacts
/
lists
curl -X POST https://api.teli.ai/v1/contacts/lists \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": "{group_id}",
    "organization_id": "{org_id}",
    "user_id": "{user_id}",
    "contacts": [
      {"phone_number": "+15551234567", "first_name": "John", "last_name": "Doe"},
      {"phone_number": "+15559876543", "first_name": "Jane", "last_name": "Smith"}
    ]
  }'

{
  "success": true,
  "list_id": "1763072372500x777103986713560785",
  "group_name": "November Leads",
  "contacts_imported": 25,
  "contact_ids": [
    "1763072372500x111222333444555666",
    "1763072372500x222333444555666777"
  ],
  "message": "25 contacts added to group 'November Leads'",
  "powered_by": "Teli"
}

​
Description

Upload contacts to an existing group. Supports two formats:
  1. JSON Body - Send contacts as a JSON array
  2. CSV Upload - Upload a CSV file with contacts
Important: Create a group first using POST /v1/contacts/groups, then upload contacts to it.

​
Authorizations

​
X-API-Key
string
required
Authentication header

​
Option 1: JSON Body

​
list_id
string
required
Group unique_id to add contacts to. Create a group first using POST /v1/contacts/groups.
​
organization_id
string
required
Organization unique_id
​
user_id
string
required
User unique_id (who is uploading the contacts)
​
contacts
array
required
Array of contact objects. Each contact must have phone_number (required). Optional fields: first_name, last_name, email

​
Option 2: CSV Upload (multipart/form-data)

​
file
file
required
CSV file with contacts. Must have phone_number (or phone, mobile, cell) column.
​
list_id
string
required
Group unique_id to add contacts to. Create a group first using POST /v1/contacts/groups.
​
organization_id
string
required
Organization unique_id
​
user_id
string
required
User unique_id (who is uploading)

​
Supported CSV Columns

ColumnAlternatives
phone_numberphone, mobile, cell
first_namefirstname, first
last_namelastname, last
email-
address_line_1address, street
city-
state-
zip_codezip, postal_code
Any additional columns are stored in extra_data. 
curl -X POST https://api.teli.ai/v1/contacts/lists \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": "{group_id}",
    "organization_id": "{org_id}",
    "user_id": "{user_id}",
    "contacts": [
      {"phone_number": "+15551234567", "first_name": "John", "last_name": "Doe"},
      {"phone_number": "+15559876543", "first_name": "Jane", "last_name": "Smith"}
    ]
  }'

{
  "success": true,
  "list_id": "1763072372500x777103986713560785",
  "group_name": "November Leads",
  "contacts_imported": 25,
  "contact_ids": [
    "1763072372500x111222333444555666",
    "1763072372500x222333444555666777"
  ],
  "message": "25 contacts added to group 'November Leads'",
  "powered_by": "Teli"
}