Create Campaign

You can create a campaign using this API. Using this API, you can set the campaign name, subject line, sender address; choose the intended mailing list.

Scope required

ZohoCampaigns.campaign.CREATE

Other alternative scopes

ZohoCampaigns.campaign.CREATE-UPDATE (CREATE + UPDATE)
ZohoCampaigns.campaign.WRITE (CREATE + UPDATE + DELETE)
ZohoCampaigns.campaign.ALL (CREATE + UPDATE + DELETE + READ)

Header:

Content-Type: application/x-www-form-urlencoded
Authorization: Zoho-oauthtoken <access_token>

Request Type:

POST

Request URL

https://campaigns.zoho.com/api/v1.1/createCampaign

API Limit

Duration: 5 mins
Number of Calls: 500
Lock Period: 30 mins

You can send 500 API calls per 5 minutes. If you hit this limit, you can't use this API for the next 30 minutes due to security reasons, but you can still use other APIs if their lock period hasn’t been reached.

List of Parameters:

Parameter	Data Type	Description
resfmt	String	xml (or) json
campaignname*	String	A name to your campaign
from_email*	String	Email address
subject*	String	Subject line
content_url	String	A valid HTML URL for your campaign content
list_details*	JSON(UTF-8 encoded)	{listkey:[segment_ID,...],listkey:...} - encoded value (You can get list key and segment ID from getmailinglists API)
topicId	String	Create a campaign with contacts that belong to this topic as recipients.

Note :

topicId is mandatory for organizations or accounts that have enabled the updated topic management version.

Possible error cases

Error code	Description
500	An internal error occured while processing your request.
1001	"resfmt" pattern does not match.
1004	Invalid URL for content import.
3001	Campaign content cannot exceed 300000 characters.
6606	No lists selected for this campaign.

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

Sample XML Request

Copiedhttps://campaigns.zoho.com/api/v1.1/createCampaign?resfmt=xml&campaignname=newsletter&from_email=patricia@zoho.com&subject=festive offer&list_details=%7B34594177d382061b27dd314490758f5d%3A%5B4000000023018 %5D%2C34594177d382061b939770a6d682df24%3A%5B%5D%7D%0A

Sample Response

Copied<response>
	<message>Campaign created successfully</message>
	<campaignKey>10234695</campaignKey>
	<code>200</code>
	<uri>/api/v1.1/createCampaign</uri>
</response>

Sample JSON Request

Copiedhttps://campaigns.zoho.com/api/v1.1/createCampaign?resfmt=json&campaignname=newsletter&from_email=patricia@zoho.com&subject=festive offers&list_details=%7B34594177d382061b27dd314490758f5d%3A%5B4000000023018 %5D%2C34594177d382061b939770a6d682df24%3A%5B%5D%7D%0A

Sample Response

Copied{
  "message": "Campaign created successfully",
  "campaignKey": "10234695",
  "code": "200",
  "uri": "/api/v1.1/createCampaign"
}