Add New List and Subscribers

Add New List and Subscribers

Users can add new list and subscribers in the list using our API.

Request URL

XML/ JSON

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

Request Type: Post

List of Parameters

Parameter

Data Type

Description

authtoken*
scope*

String
String

API Authentication Token
CampaignsAPI

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.

listname*

String

Provide your list name.

signupform*

String

public/private.

mode*

String

newlist

listdescription

String

Provide a description for your list.

* - Mandatory Parameters

Sample Request:

XML/ JSON

https://campaigns.zoho.com/api/addlistandcontacts?authtoken=[AUTHTOKEN]&scope=[CampaignsAPI]&resfmt=[XML/JSON]&listname=[give ur list name]&signupform=[public/private]&mode=newlist&listdescription=[give your list description]&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/addlistandcontacts" 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/addlistandcontacts","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