Our v3 API is now available! Learn more by visiting the v3 developer portal.

Email Campaign Schedule Collection

Use this endpoint to retrieve (GET) an existing schedule or create (POST) a new schedule for an email campaign.

Methods:

Click a method to view its documentation

GET POST

DescriptionTOP

Privileges required: campaign:activate

Schedule an email campaign specified by the campaignId path parameter to run and be sent out. Define the date and time that the email campaign will be submitted to the send queue (in ISO 8601 format) using the scheduled_date property. You can create a schedule only for an email campaign in DRAFT or SENT status.

When scheduling a campaign, please provide a lead time of at least 20 minutes; otherwise, you may receive an invalid schedule error response.

NOTE: The account must be in good standing to be able to schedule and send an email campaign. 

Sending a Campaign "Now"

To send a campaign "now", only include {} in the JSON request payload. When using the Send Now function, the response body will show the time that the scheduling request was made, not the time the email campaign will be sent. Send Now puts the campaign into the queue for the next send window, which occur on a regular basis, generally every 5 minutes.

Resending a Campaign

You can resend an existing campaign that has a SENT status using this endpoint. The campaign will only be sent to contacts that have been added to the contact lists since the last time the campaign was sent (based on the last_run_date value)

POST: https://api.constantcontact.com/v2/emailmarketing/campaigns/{campaignId}/schedules

Test API

name

type

default

description

api_key

query

REQUIRED; The API key for the application

campaignId

path

Specifies the email campaign to create a schedule for

Example JSON Request BodyTOP

{ 
  "scheduled_date" : "2013-05-10T11:07:43.626Z" 
}

Response CodesTOP

code

description

201

Campaign Schedule was successfully created

400

Either JSON was malformed or there was a data validation error

401

Authentication failure

406

Unsupported accept header value, must be application/json

415

Unsupported content-type in the header, use application/json

500

Internal server error occurred

StructureTOP

property

type(max length)

description

id

string

Uniquely identifies an email campaign schedule

scheduled_date

string

The scheduled date and time for the email campaign, in ISO 8601 format with support for UTC and UTC offset

Example ResponseTOP

{ 
  "schedule_id" : "1", 
  "scheduled_date" : "2013-05-10T11:07:43.626Z" 
}