Skip to main content
PATCH
Update lead

Authorizations

Authorization
string
header
required

Use Authorization: Bearer tc_live_xxxxx

Path Parameters

id
string<uuid>
required

Body

application/json
name
string
Minimum string length: 1
phone_number
string

Phone number in E.164 format (also validated as dialable; country codes that don't exist are rejected)

Pattern: ^\+[1-9]\d{8,14}$
email
string<email> | null
status
enum<string>
Available options:
New,
Contacted,
Converted,
Unsubscribed
notes
string | null
notes_append
string
tags
string[]
metadata
object

Response

OK

id
string<uuid>
required
account_id
string<uuid>
required
name
string
required
phone_number
string
required
Pattern: ^\+[1-9]\d{8,14}$
status
enum<string>
required
Available options:
New,
Contacted,
Converted,
Unsubscribed
tags
string[]
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
email
string<email> | null
notes
string | null
metadata
object
converted_at
string<date-time> | null
list_ids
string<uuid>[]