Total Subscribers

Total Subscribers

You don’t have to research on how effective a list has been or how much reach does a particular list measure. Find out using our API Authentication Token to find out the number of subscribers in a list.

Request URL

https://campaigns.zoho.com/api/listsubscriberscount

Request Type: Get

List of Parameters

Parameter

Data Type

Description

authtoken*
scope*

String
String

API Authentication Token
Campaigns API

listkey*

String

List Key to send a subscription mail to subscribers

version

String

This will fetch responses based on the current API version

resfmt

String

XML (or) JSON

status

String

[active|unsub|bounce|spam]

* - Mandatory Parameter

Sample Request:

https://campaigns.zoho.com/api/listsubscriberscount?authtoken=[API Authentication Token]&scope=CampaignsAPI&version=1&resfmt=[XML/JSON]&listkey=[listkey  ]&status= [active|unsub|bounce|spam]

Sample Response:

Our API response will let you know of the following be it in the XML or JSON format:

XML format:

<response uri="/api/listsubscriberscount" version="1"><code>0</code><status>success</status><no_of_contacts>2</no_of_contacts></response>

JSON format:

{"status":"success","code":"0","uri":"/api/listsubscriberscount","no_of_contacts":2,"version":"1"}

Possible error cases

Error code Description
2202Listkey is empty or invalid.
2707 Error in displaying reports. Please retry after sometime.
2704Insufficient privilege to access other users' mailing list. 
2701Insufficient privilege to access your mailing list.
2001Please enter correct XML(or)JSON format. 

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

Share this post : FacebookTwitter

Still can't find what you're looking for?

Write to us: support@zohocampaigns.com