Skip to main content
POST
/
v1
/
contacts
curl -X POST https://api.teli.ai/v1/contacts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "organization_id": "{org_id}",
    "user_id": "{user_id}",
    "list_id": "{group_id}",
    "phone_number": "+15551234567",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com"
  }'

{
  "success": true,
  "contact_id": "contact_1767123456789x123456789012345",
  "list_id": "1763072372500x777103986713560785",
  "group_name": "November Leads",
  "message": "Contact created successfully",
  "powered_by": "Teli"
}

​
Description

Create a single contact with detailed information including personal, company, and industry-specific fields. Important: Contacts must belong to a group. Create a group first using POST /v1/contacts/groups, then add contacts to it.

​
Authorizations

​
X-API-Key
string
required
Authentication header

​
Required Fields

​
organization_id
string
required
Organization unique_id
​
user_id
string
required
User unique_id (who is creating the contact)
​
list_id
string
required
Group unique_id to add the contact to. Create a group first using POST /v1/contacts/groups.
​
phone_number
string
required
Contact phone number (E.164 format recommended, e.g., +15551234567)

​
Personal Information

​
first_name
string
First name
​
middle_name
string
Middle name
​
last_name
string
Last name
​
email
string
Email address
​
birthday
string
Birthday (YYYY-MM-DD format)
​
address_line_1
string
Street address line 1
​
address_line_2
string
Street address line 2 (apt, suite, etc.)
​
city
string
City
​
state
string
State
​
zip_code
string
Zip/postal code
​
country
string
Country
​
opportunity_value
string
Lead opportunity value (e.g., “$500”)
​
lead_source
string
Where the lead came from (e.g., “Facebook”, “Referral”)
​
external_id
string
Your CRM’s ID for this contact

​
Company Information

​
company_name
string
Company name
​
company_industry
string
Industry (e.g., “Real Estate”, “Finance”)
​
position
string
Job title/position
​
years_worked
string
Years at company
​
npn
string
National Producer Number (for insurance professionals)
​
crd
string
Central Registration Depository number (for financial advisors)
​
company_address_line_1
string
Company street address
​
company_address_line_2
string
Company address line 2
​
company_city
string
Company city
​
company_state
string
Company state
​
company_zip_code
string
Company zip code
​
company_country
string
Company country

​
Industry-Specific Fields (Finance & Real Estate)

​
ssn_last_4
string
Last 4 digits of SSN (for verification purposes)
​
fico_score
string
Credit score (300-850)
​
debt_type
string
Type of debt (e.g., “VA Loan”, “FHA”, “Conventional”)
​
current_loan_balance
string
Current loan balance
​
monthly_payment
string
Current monthly payment
​
lender_name
string
Current lender name
​
months_since_mortgage_open
string
Months since mortgage account opened
​
client_goal
string
Client’s financial goal

​
Notes

​
notes
string
Free-text notes about the contact
curl -X POST https://api.teli.ai/v1/contacts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "organization_id": "{org_id}",
    "user_id": "{user_id}",
    "list_id": "{group_id}",
    "phone_number": "+15551234567",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com"
  }'

{
  "success": true,
  "contact_id": "contact_1767123456789x123456789012345",
  "list_id": "1763072372500x777103986713560785",
  "group_name": "November Leads",
  "message": "Contact created successfully",
  "powered_by": "Teli"
}