Recently Sent Campaigns

You might want to reflect campaign data in your website. Using this API will help you view the email campaign that was recently sent.

Request Type:

Scope required

ZohoCampaigns.campaign.READ

Other alternative scopes

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

Header:

Authorization: Zoho-oauthtoken <access_token>

Request URL:

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

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: -- Version 1.1

Parameter	Data Type	Description
limit*	Integer	Limit to fetch Recent campaigns from campaigns list
version	String	This will fetch responses based on the current API version
resfmt	String	XML (or) JSON

* - Mandatory Parameter

Sample XML Request

Copiedhttps://campaigns.zoho.com/api/v1.1/recentsentcampaigns?resfmt=XML

Sample Response

Copied<response uri="/api/recentsentcampaigns" version="1.1">
	<br/>
	<status>success</status>
	<br/>
	<p>
		<code>0</code>
		<br/>
		<recent-sent-campaigns>
			<br/>
			<p>
				<campaign no="1">
					<br/>
					<fl val="sent_time">1342503703000</fl>
					<br/>
					<fl val="campaign_name">CAMPAIG</fl>
					<br/>
					<fl val="campaign_key">34594177d382061b99f747d905612a4b</fl>
					<br/>
					<fl val="created_time">1342503640000</fl>
					<br/>
				</campaign>
				<br/>
				<campaign no="2">
					<br/>
					<fl val="sent_time">1342503459000</fl>
					<br/>
					<fl val="campaign_name">CAMPAIG</fl>
					<br/>
					<fl val="campaign_key">34594177d382061b56febfd0cb811b03</fl>
					<br/>
					<fl val="created_time">1342503425000</fl>
					<br/>
				</campaign>
				<br/>
				<campaign No="3">
					<br/>
					<fl val="sent_time">1342502423000</fl>
					<br/>
					<fl val="campaign_name">CAMPAIG</fl>
					<br/>
					<fl val="campaign_key">34594177d382061b2bf0c3fb3e40110b</fl>
					<br/>
					<fl val="created_time">1342502300000</fl>
					<br/>
				</campaign>
				<br/>
			</recent-sent-campaigns>
			<br/>
		</response>

Sample JSON Request

Copiedhttps://campaigns.zoho.com/api/v1.1/recentsentcampaigns?resfmt=[JSON]

Sample Request

Copied{
  "recent_sent_campaigns": "[{sent_time=1342503703000, campaign_name=CAMPAIG, campaign_key=34594177d382061b99f747d905612a4b, created_time=1342503640000}, {sent_time=1342503459000, campaign_name=CAMPAIG, campaign_key=34594177d382061b56febfd0cb811b03, created_time=1342503425000}, {sent_time=1342502423000, campaign_name=CAMPAIG, campaign_key=34594177d382061b2bf0c3fb3e40110b, created_time=1342502300000}]",
  "status": "success",
  "code": "0",
  "uri": "/api/recentsentcampaigns",
  "version": "1.1"
}