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_idStringTopic 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"
}