Add leads in existing list
Did you know that you can also add leads not only to a new list but also existing lists using API? Well, using this API you can add leads in existing list.
Scope required
ZohoMarketingAutomation.lead.CREATE
Other alternative scopes
ZohoMarketingAutomation.lead.CREATE-UPDATE (CREATE + UPDATE)
ZohoMarketingAutomation.lead.WRITE (CREATE + UPDATE + DELETE)
ZohoMarketingAutomation.lead.ALL (CREATE + UPDATE + DELETE + READ)
Header:
Authorization: Zoho-oauthtoken <access_token>
Content-Type: application/x-www-form-urlencoded
Request type:
Post
Request URL
https://marketingautomation.zoho.com/api/v1/addleadsinbulk
List of parameters
Parameter | Data type | Description |
listkey* | String | List Key to send a subscription mail to Leads in the list. |
resfmt | String | JSON |
emailids* | String | Provide maximum of ten (10) EMAILID's comma (,) separately. |
topic_id | String | Topic ID to subscribe topics to leads in the mailing list. You can pass comma separated topic IDs as well. |
* - Mandatory parameters
Possible Error Cases
Error code | Descriptionn |
903 | Mandatory fields are missing. |
2205 | Duplicate list name is found. |
2206 | List has been deleted. |
2302 | You cannot add leads as you've reached the maximum limit. |
If your error code is not listed above, click here.
Sample request
Copiedhttps://marketingautomation.zoho.com/api/v1/addleadsinbulk?listkey=listkey&resfmt=[JSON]&emailids=[email addresses]
Sample Response
Copied {
"status": "success",
"listkey": "f70c4878c4a471691e3931dd52bedc79",
"code": "0",
"url": "/api/v1/addleadsinbulk",
"listname": "1issst1oo1deed88",
"version": "1"
}