Create Campaign

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

Scope required

  • ZohoMarketingAutomation.campaign.CREATE

Other alternative scopes

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

Header:

Authorization:Zoho-oauthtoken

Content-Type: application/x-www-form-urlencoded

Request type:

  • POST

Request URL

https://marketingautomation.zoho.com/api/v1/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

 

 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

 

StringCreate a campaign with contacts that belong to this topic as recipients. 

* Mandatory parameters

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.
6606No lists selected for this campaign.

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

Sample request

Copiedhttps://marketingautomation.zoho.com/api/v1/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/createCampaign"
}