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
API Limit
- Duration: 5 mins
- Number of Calls: 500
- Lock Period: 30 mins
You can send 500 API calls per 5 minutes. If you hit this limit, you can't use this API for the next 30 minutes due to security reasons, but you can still use other APIs if their lock period hasn’t been reached.
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"
}