v1

latestSwagger 2.0Private2026-08-04128286690.5 KB
Email Scheduling

POST (Create) an Email Campaign Activity Schedule

Use this method to send an email campaign activity to contacts either immediately or on a specific date. To send the email campaign activity immediately, specify 0 for the scheduled_date request property (results return an empty array). To send the email campaign activity on a specific date, specify the date using the scheduled_date request property (results return the scheduled date in an array).

Before you schedule an email campaign activity, you must update the email campaign activity and specify which contacts you want Constant Contact to send the email to. When you make a PUT call to update an email campaign activity, use the contact_list_ids or segment_ids array to add contacts.

You can only schedule email campaign activities that have the primary_email role and are in DRAFT, DONE, or ERROR status. When you schedule an email campaign activity in DONE status, Constant Contact does not send the email campaign activity to contacts that already received it. Constant Contact only sends the email campaign activity to any new contacts in the contact lists or segment you use.

post/emails/activities/{campaign_activity_id}/schedules

Path parameters

campaign_activity_idstring uuid required

The unique ID for an email campaign activity. You can only schedule email campaign activities that have the primary_email role.

Request body

scheduled_datestring date-time required

The date when Constant Contact will send the email campaign activity to contacts in ISO-8601 format. For example, <code>2022-05-17</code> and <code>2022-05-17T16:37:59.091Z</code> are valid dates. Use <code>"0"</code> as the date to have Constant Contact immediately send the email campaign activity to contacts.

Response

Request successful.

scheduled_datestring date-time

The date when Constant Contact will send the email campaign activity to contacts in ISO-8601 format. For example, <code>2022-05-17</code> and <code>2022-05-17T16:37:59.091Z</code> are valid dates.