Add Subscribers in Existing List

Add Subscribers in Existing List

Users can add subscribers in existing list using our API.

Request URL

XML/ JSON

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

Request Type: Post

List of Parameters

Parameter

Data Type

Description

authtoken*
scope*

String
String

API Authentication Token
CampaignsAPI

listkey*

String

List Key to send a subscription mail to subscribers in the list.

version

String

This will fetch responses based on current API version.

resfmt

String

XML (or) JSON

emailids*

String

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

* - Mandatory Parameters

Sample Request:

XML/ JSON

https://campaigns.zoho.com/api/addlistsubscribersinbulk?authtoken=[API Authentication Token]&scope=CampaignsAPI&listkey=listkey&resfmt=[XML/JSON]&emailids=[email addresses]

Sample Response:

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

XML Format:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<response uri="/api/addlistsubscribersinbulk" version="1">

<code>0</code>

<status>success</status>

<listkey>f70c4878c4a471692bb9a99a2d5ed3a7</listkey>

<listname>1issst11deed88</listname>

</response>

JSON format:

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

Possible Error Cases

Error code Description
903Mandatory fields are missing.
2205 Duplicate list name is found.
2206List has been deleted.
2302You cannot add subscribers as you've reached the maximum limit. 

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