AddLeadsToList | HeyReach API Documentation

Add leads to a lead list. Add up to 100 leads per request.

The name field in the customUserFields array of the leads you are importing, must contain only alpha-numeric characters or underscores _. An error will be return in the case the name field does not follow this format.

Be aware that adding leads to a list is not the same as addig them to a campaign. If the campaign is in a finished state or has already used all the leads in it, then leads added to the list will not be started in the campaign. If you want to add the leads to a specific campaign, then use the AddLeadsToCampaign or AddLeadsToCampaignV2 methods.

Add leads to a lead list. Add up to 100 leads per request. **The** **`name`** **field in the** **`customUserFields`** **array of the leads you are importing, must contain only alpha-numeric characters or underscores** **`_`**. **An error will be return in the case the** **`name`** **field does not follow this format.** **Be aware that adding leads to a list is not the same as addig them to a campaign. If the campaign is in a finished state or has already used all the leads in it, then leads added to the list will not be started in the campaign. If you want to add the leads to a specific campaign, then use the AddLeadsToCampaign or AddLeadsToCampaignV2 methods.**

Request

This endpoint expects an object.

leadslist of objectsRequired

listIdintegerRequired

Response

Errors

400

Add Leads to List Lists Request Bad Request Error

401

Add Leads to List Lists Request Unauthorized Error

404

Add Leads to List Lists Request Not Found Error

429

Add Leads to List Lists Request Too Many Requests Error

Headers

Request

Response

Errors