Get mailing lists

Using this API, you can fetch the mailing lists and it'll be notified automatically.

Scope required

  • ZohoMarketingAutomation.lead.READ

Other alternative scopes

  • 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/getmailinglists

List of parameters

Parameter

Data type

Description

resfmt

String

JSON

sort

String

asc/desc

fromindex

Number

Values in number

range

Number

Values in number

* - Mandatory parameters

Possible error cases

Error code

Description

1004

Unable to find the resource you're looking for. Please recheck the documentation and try again.

2706

Insufficient privilege to access the list.

2402

Error in displaying details. Please try after sometime.

2401

No mailing list has been created. Please create a list.

If your error code is not listed above, click here.

Sample request


				https://marketingautomation.zoho.com/api/v1/getmailinglists?resfmt=JSON&sort=[asc/desc]&fromindex=[number]&range=[number]			

Sample response


				{
"requestdetails": {
"sort": "Ascending Order",
"range": 2,
"fromindex": 1
},
"status": "success",
"list_of_details": [
{
"created_date": "1316108278000",
"segments": "{}",
"lockstatus": "unlocked",
"listunino": "6361736964559881",
"date": "15 Sep 2011, 03:07 PM",
"noofleads": "57",
"listname": "1",
"zuid": "229788",
"noofunsubcnt": "0",
"is_public": "false",
"noofbouncecnt": "0",
"owner": "Naveen",
"listkey": "3c20ad524dfa4af86216a5be13e238ed"
},
{
"created_date": "1358908439000",
"segments": "{}",
"lockstatus": "unlocked",
"listunino": "6361736976335832",
"date": "23 Jan 2013, 12:03 AM",
"noofleads": "1393",
"listname": "111",
"zuid": "8846468",
"noofunsubcnt": "2",
"is_public": "true",
"noofbouncecnt": "0",
"owner": "john.doe.b",
"listkey": "3c20ad524dfa4af85c20ad3564a05789"
}
],
"code": "0",
"uri": "/api/v1/getmailinglists",
"version": "1"
}