curl --request PUT \
--url https://api.trysela.com/api/leads/update/ \
--header 'Authorization: Token <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"external_id": "id_in_your_crm_123",
"phone_number": "+18042221111",
"email": "first_name@trysela.com",
"status": "CANCELLED"
}'{
"id": 28013,
"email": "first_name@trysela.com",
"phone_number": "+18042221111",
"metadata": {
"phone_number": "+18042221111",
"email": "first_name@trysela.com",
"first_name": "First",
"last_name": "Name",
"timezone": "America/Los_Angeles",
"created_at": "02/28/2025 15:09",
"property_address": "123 Main St",
"property_city": "San Francisco",
"property_state": "California",
"property_zip": "94101",
"address": "456 2nd St",
"city": "Los Angeles",
"state": "California",
"zip": "90001",
"lead_source": "USDALoans.com",
"external_id": "id_in_your_crm_123"
},
"modified_time": "2025-02-28T15:09:03.139554-08:00",
"created_time": "2025-02-28T15:09:03.122515-08:00",
"status": "OPEN",
"status_reason": null,
"lead_source": "USDALoans.com",
"lead_type": 123,
"representative": 456,
"next_call_time": "2025-02-28T15:09:03.122515-08:00",
"next_call_time_reason": "FIRST_CALL",
"external_id": "id_in_your_crm_123",
"us_state": "CA",
"received_time": "2025-02-28T15:09:03.122515-08:00",
"reengagements_count": 0,
"last_reengagement_time": null,
"call_schedule_start_time": null,
"sms_dnc": false,
"call_dnc": false
}Update a Lead with Phone / Email Match
Updates a lead a using the phone number and the email to find a matching lead.
curl --request PUT \
--url https://api.trysela.com/api/leads/update/ \
--header 'Authorization: Token <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"external_id": "id_in_your_crm_123",
"phone_number": "+18042221111",
"email": "first_name@trysela.com",
"status": "CANCELLED"
}'{
"id": 28013,
"email": "first_name@trysela.com",
"phone_number": "+18042221111",
"metadata": {
"phone_number": "+18042221111",
"email": "first_name@trysela.com",
"first_name": "First",
"last_name": "Name",
"timezone": "America/Los_Angeles",
"created_at": "02/28/2025 15:09",
"property_address": "123 Main St",
"property_city": "San Francisco",
"property_state": "California",
"property_zip": "94101",
"address": "456 2nd St",
"city": "Los Angeles",
"state": "California",
"zip": "90001",
"lead_source": "USDALoans.com",
"external_id": "id_in_your_crm_123"
},
"modified_time": "2025-02-28T15:09:03.139554-08:00",
"created_time": "2025-02-28T15:09:03.122515-08:00",
"status": "OPEN",
"status_reason": null,
"lead_source": "USDALoans.com",
"lead_type": 123,
"representative": 456,
"next_call_time": "2025-02-28T15:09:03.122515-08:00",
"next_call_time_reason": "FIRST_CALL",
"external_id": "id_in_your_crm_123",
"us_state": "CA",
"received_time": "2025-02-28T15:09:03.122515-08:00",
"reengagements_count": 0,
"last_reengagement_time": null,
"call_schedule_start_time": null,
"sms_dnc": false,
"call_dnc": false
}Authorizations
Body
Any additional information associated with the lead as json metadata. Any of the values supplied here can be used by the agent in the talk track. Any additional payload fields that are not part of the standard lead fields will be automatically stored in the metadata upon lead creation or update, so lead metadata can also be sent as additional keys in the payload. Common fields to include in the metadata are first_name and last_name.
The status of the lead. This is updated automatically.
UNKNOWN- UnknownNEW- NewOPEN- OpenCALLBACK_TO_TRANSFER- Callback to transferCLOSED- ClosedCLOSED_INCOMPLETE- Closed incompleteLOST- LostSCHEDULE_COMPLETED- Schedule completedOUT_OF_TERRITORY- Out of territoryBAD_NUMBER- Bad numberCANCELLED- Cancelled
UNKNOWN, NEW, OPEN, CALLBACK_TO_TRANSFER, CLOSED, CLOSED_INCOMPLETE, LOST, SCHEDULE_COMPLETED, OUT_OF_TERRITORY, BAD_NUMBER, CANCELLED Sub-type of the status outcome (e.g. blind_transfer, warm_transfer, appointment_booked). This is updated automatically.
blind_transfer- Blind transferwarm_transfer- Warm transferappointment_booked- Appointment bookedlive_handoff_unavailable- Live handoff unavailableescalation- Escalationhas_call_dnc- Has call DNCtcpa_litigator- TCPA litigatorLEAD_ASSIGNED- Lead assignedapplication_link_sms- Application link SMS
blind_transfer, warm_transfer, appointment_booked, live_handoff_unavailable, escalation, has_call_dnc, tcpa_litigator, LEAD_ASSIGNED, application_link_sms The US state of the lead. This is used to determine the timezone of the lead, as well as for compliance with telemarketing regulations.
AL- AlabamaAK- AlaskaAS- American SamoaAZ- ArizonaAR- ArkansasAA- Armed Forces AmericasAE- Armed Forces EuropeAP- Armed Forces PacificCA- CaliforniaCO- ColoradoCT- ConnecticutDE- DelawareDC- District of ColumbiaFL- FloridaGA- GeorgiaGU- GuamHI- HawaiiID- IdahoIL- IllinoisIN- IndianaIA- IowaKS- KansasKY- KentuckyLA- LouisianaME- MaineMD- MarylandMA- MassachusettsMI- MichiganMN- MinnesotaMS- MississippiMO- MissouriMT- MontanaNE- NebraskaNV- NevadaNH- New HampshireNJ- New JerseyNM- New MexicoNY- New YorkNC- North CarolinaND- North DakotaMP- Northern Mariana IslandsOH- OhioOK- OklahomaOR- OregonPA- PennsylvaniaPR- Puerto RicoRI- Rhode IslandSC- South CarolinaSD- South DakotaTN- TennesseeTX- TexasUT- UtahVT- VermontVI- Virgin IslandsVA- VirginiaWA- WashingtonWV- West VirginiaWI- WisconsinWY- Wyoming
AL, AK, AS, AZ, AR, AA, AE, AP, CA, CO, CT, DE, DC, FL, GA, GU, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, MP, OH, OK, OR, PA, PR, RI, SC, SD, TN, TX, UT, VT, VI, VA, WA, WV, WI, WY Response
Lead updated successfully.
Any additional information associated with the lead as json metadata. Any of the values supplied here can be used by the agent in the talk track. Any additional payload fields that are not part of the standard lead fields will be automatically stored in the metadata upon lead creation or update, so lead metadata can also be sent as additional keys in the payload. Common fields to include in the metadata are first_name and last_name.
The status of the lead. This is updated automatically.
UNKNOWN- UnknownNEW- NewOPEN- OpenCALLBACK_TO_TRANSFER- Callback to transferCLOSED- ClosedCLOSED_INCOMPLETE- Closed incompleteLOST- LostSCHEDULE_COMPLETED- Schedule completedOUT_OF_TERRITORY- Out of territoryBAD_NUMBER- Bad numberCANCELLED- Cancelled
UNKNOWN, NEW, OPEN, CALLBACK_TO_TRANSFER, CLOSED, CLOSED_INCOMPLETE, LOST, SCHEDULE_COMPLETED, OUT_OF_TERRITORY, BAD_NUMBER, CANCELLED Sub-type of the status outcome (e.g. blind_transfer, warm_transfer, appointment_booked). This is updated automatically.
blind_transfer- Blind transferwarm_transfer- Warm transferappointment_booked- Appointment bookedlive_handoff_unavailable- Live handoff unavailableescalation- Escalationhas_call_dnc- Has call DNCtcpa_litigator- TCPA litigatorLEAD_ASSIGNED- Lead assignedapplication_link_sms- Application link SMS
blind_transfer, warm_transfer, appointment_booked, live_handoff_unavailable, escalation, has_call_dnc, tcpa_litigator, LEAD_ASSIGNED, application_link_sms The reason for the current status of the lead. This is updated automatically.
UNKNOWN- UnknownWEBHOOK- WebhookMANUAL- ManualCHAT- ChatREENGAGEMENT- Reengagement
UNKNOWN, WEBHOOK, MANUAL, CHAT, REENGAGEMENT The US state of the lead. This is used to determine the timezone of the lead, as well as for compliance with telemarketing regulations.
AL- AlabamaAK- AlaskaAS- American SamoaAZ- ArizonaAR- ArkansasAA- Armed Forces AmericasAE- Armed Forces EuropeAP- Armed Forces PacificCA- CaliforniaCO- ColoradoCT- ConnecticutDE- DelawareDC- District of ColumbiaFL- FloridaGA- GeorgiaGU- GuamHI- HawaiiID- IdahoIL- IllinoisIN- IndianaIA- IowaKS- KansasKY- KentuckyLA- LouisianaME- MaineMD- MarylandMA- MassachusettsMI- MichiganMN- MinnesotaMS- MississippiMO- MissouriMT- MontanaNE- NebraskaNV- NevadaNH- New HampshireNJ- New JerseyNM- New MexicoNY- New YorkNC- North CarolinaND- North DakotaMP- Northern Mariana IslandsOH- OhioOK- OklahomaOR- OregonPA- PennsylvaniaPR- Puerto RicoRI- Rhode IslandSC- South CarolinaSD- South DakotaTN- TennesseeTX- TexasUT- UtahVT- VermontVI- Virgin IslandsVA- VirginiaWA- WashingtonWV- West VirginiaWI- WisconsinWY- Wyoming
AL, AK, AS, AZ, AR, AA, AE, AP, CA, CO, CT, DE, DC, FL, GA, GU, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, MP, OH, OK, OR, PA, PR, RI, SC, SD, TN, TX, UT, VT, VI, VA, WA, WV, WI, WY