Add New List and Leads

Using this API, you can add new list and leads in the list without having to do this manually in the product UI.

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)

    Request Type

    • Post

    Header:

    Authorization: Zoho-oauthtoken <access_token>

    Content-Type: application/x-www-form-urlencoded

    Request URL

    https://marketingautomation.zoho.com/api/v1/addlistandleads

    List of parameters

    Parameter

    Data Type

    Description

    resfmt

    String

    JSON

    emailids*

    String

    Provide maximum of ten (10) EMAILID's comma (,) separately.

    listname*

    String

    Provide your list name.

    signupform*

    String

    public/private.

    mode*

    String

    newlist

    listdescription

    String

    Provide a description for your list.

    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

    Description

    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/addlistandleads?resfmt=JSON&listname=[give ur list name]&signupform=[public/private]&mode=newlist&listdescription=[give your list description]&emailids=[email addresses]

    Sample Response

    Copied{
"status": "success",
"listkey": "f70c4878c4a471691e3931dd52bedc79",
"code": "0",
"url": "/api/v1/addlistandleads",
"listname": "1issst1oo1deed88",
"version": "1"
}