Skip to main content
PATCH
/
v1
/
contacts
/
leads
/
{lead_id}
Update Contact
curl --request PATCH \
  --url https://api.example.com/v1/contacts/leads/{lead_id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "middle_name": "<string>",
  "email": "<string>",
  "phone_number": "<string>",
  "birthday": "<string>",
  "address_line_1": "<string>",
  "address_line_2": "<string>",
  "city": "<string>",
  "state": "<string>",
  "zip_code": "<string>",
  "country": "<string>",
  "company_name": "<string>",
  "company_position": "<string>",
  "company_industry": "<string>",
  "lead_source": "<string>",
  "lead_status": "<string>",
  "lead_priority": "<string>",
  "external_id": "<string>",
  "notes": "<string>",
  "fico_score": "<string>",
  "loan_balance": "<string>",
  "interest_rate": "<string>",
  "lender_name": "<string>"
}
'
{
  "success": true,
  "lead": {},
  "message": "<string>"
}
Update one or more fields on an existing contact. Only provided fields are updated; all other fields remain unchanged.

​
Authentication

​
X-API-Key
string
required
Your API key

​
Path Parameters

​
lead_id
string
required
The contact’s unique_id

​
Body

Send a JSON object with the fields you want to update. Only include fields that need to change.

​
Personal Fields

​
first_name
string
First name
​
last_name
string
Last name
​
middle_name
string
Middle name
​
email
string
Email address
​
phone_number
string
Phone number
​
birthday
string
Birthday (date format)

​
Address Fields

​
address_line_1
string
Street address
​
address_line_2
string
Apartment, suite, unit, etc.
​
city
string
City
​
state
string
State
​
zip_code
string
Zip / Postal code
​
country
string
Country

​
Company Fields

​
company_name
string
Company name
​
company_position
string
Job title or position
​
company_industry
string
Industry

​
CRM Fields

​
lead_source
string
Lead source identifier
​
lead_status
string
Lead status
​
lead_priority
string
Lead priority level
​
external_id
string
Your system’s ID for this contact
​
notes
string
Free-text notes about this contact

​
Financial Fields

​
fico_score
string
Credit score
​
loan_balance
string
Loan balance
​
interest_rate
string
Interest rate
​
lender_name
string
Lender name
All financial, sales, and industry-specific fields (loan_type, debt_balance, opportunity_value, client_goal, npn, crd, etc.) are also supported. See the full leads schema for all available fields.

​
Example Request

curl -X PATCH "https://api.teli.ai/v1/contacts/leads/1771008017933x138393378469989770" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jonathan",
    "company_name": "Acme Corp",
    "lead_status": "qualified",
    "notes": "Interested in premium plan"
  }'

​
Response

​
success
boolean
Whether the request was successful
​
lead
object
The updated contact record with all fields
​
message
string
Human-readable result message

​
Example Response

200
{
  "success": true,
  "lead": {
    "unique_id": "1771008017933x138393378469989770",
    "first_name": "Jonathan",
    "last_name": "Campbell",
    "email": "elliot.campbell.13@example.com",
    "phone_number": "555-0113",
    "company_name": "Acme Corp",
    "lead_status": "qualified",
    "notes": "Interested in premium plan",
    "city": "Testville",
    "state": "MI"
  },
  "message": "Contact updated successfully",
  "powered_by": "Teli"
}
404
{
  "error": "Contact not found",
  "powered_by": "Teli"
}

​
Notes

  • Only provided fields are updated; omitted fields remain unchanged
  • The contact must belong to the authenticated tenant
  • All updated fields are available for message variable substitution in campaigns: {{first_name}}, {{company_name}}, etc.