Skip to main content
PATCH
Bulk Update Leads in Campaign

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

campaign_id
string
required

Identifier of the campaign. Required.

Example:

"camp_abc123"

Body

application/json

Array of lead update objects. Each object must include phone_number to identify the lead.

Minimum array length: 1
phone_number
string
required

Phone number of the lead to update (used as identifier). Required.

Example:

"+14155552671"

first_name
string

Updated first name. Optional.

Example:

"Jane"

last_name
string

Updated last name. Optional.

Example:

"Doe"

email
string<email>

Updated email address. Optional.

Example:

"jane.doe@example.com"

do_not_call
boolean

When true, marks the lead as opted out and prevents future calls. Optional.

Allowed values: true, false.

Example:

false

custom_fields
object

Updated custom key-value fields. Optional.

Example:
mark_as_unanswered
boolean

When true, resets the lead's answered status and re-queues them for outbound calling. Only applies when the lead is currently marked as answered. Optional.

Allowed values: true, false.

Example:

true

Example:

Response

Bulk update completed. Per-lead results are included in results.

status
string
message
string
results
object[]