Lead Object

A lead is a person a campaign calls. The API returns leads with the following fields:

FieldTypeDescription
idUUIDLead identifier.
campaign_idUUIDCampaign the lead belongs to.
first_namestringLead's first name.
phone_e164stringPhone in E.164 form, e.g. +919876543210.
statusstringnew · in_progress · rescheduled · done · stopped · dnc.
custom_fieldsobjectExtra variables for the campaign.
calls_countintegerNumber of calls attempted on this lead.
updated_atdatetimeLast modified (IST).
next_scheduled_calldatetime | nullNext scheduled call, if any.

Status is system-managed. It cannot be set through the API. Use POST /api/v1/leads/{lead_id}/stop to stop a lead.