Sample code for 30+ languages & platforms
VBScript Requires Chilkat v11.0.0+

Constant Contact V3: LIVE SEND - Schedule a newsletter for a named list

See more Constant Contact Examples

LIVE SEND. Scheduling this campaign delivers email to eligible contacts on the selected list at the specified time. Use the reviewer test to check the email first. Select the intended newsletter and list in the same account. The example accepts a primary draft, replaces its entire audience with one active email list, and schedules it. List lookup requires contact_data. Editing and scheduling require campaign_data and account privileges to edit and send.

Enter a future ISO 8601 timestamp with a UTC offset or Z. To cancel before delivery starts, keep the same activity selection, change action to unschedule, and run again. Cancellation removes the schedule and keeps the audience assignment. If the scheduling response is lost, check the activity’s schedule before retrying.

Authorize the application using the same account and credential store.

Constant Contact developer guide

Chilkat VBScript Downloads

VBScript
Dim fso, outFile
Set fso = CreateObject("Scripting.FileSystemObject")
'Create a Unicode (utf-16) output text file.
Set outFile = fso.CreateTextFile("output.txt", True, True)

success = 0

'  LIVE SEND: Scheduling this activity delivers email to the selected contact list.
'  Assumes Chilkat is unlocked. See Global Unlock Sample.
set vault = CreateObject("Chilkat.Secrets")
vault.Location = "local_manager"
vault.AutoSplit = 1
set entry = CreateObject("Chilkat.JsonObject")
success = entry.UpdateString("appName","ConstantContactV3")
success = entry.UpdateString("service","OAuth2")
success = entry.UpdateString("username","my-account")
set tokens = CreateObject("Chilkat.JsonObject")
loaded = vault.GetSecretJson(entry,tokens)
If (loaded <> 1) Then
    outFile.WriteLine("Run the desktop authorization example using this account and store.")
    WScript.Quit
End If

If (tokens.JsonTypeOf("access_token") <> 1) Then
    outFile.WriteLine("The saved authorization has no access token.")
    WScript.Quit
End If

set http = CreateObject("Chilkat.Http")
http.RequireSslCertVerify = 1
http.AuthToken = tokens.StringOf("access_token")
set resp = CreateObject("Chilkat.HttpResponse")

'  Use the selection file from the draft or campaign lookup example for this account.
set selection = CreateObject("Chilkat.JsonObject")
success = selection.LoadFile("newsletter-selection.json")
activityId = selection.StringOf("campaign_activity_id")
If ((success <> 1) Or (activityId = "")) Then
    outFile.WriteLine("Select a campaign and save its primary activity ID first.")
    WScript.Quit
End If

success = http.SetUrlVar("activity",activityId)
action = "schedule"
If (action = "unschedule") Then
    success = http.HttpNoBody("DELETE","https://api.cc.email/v3/emails/activities/{$activity}/schedules",resp)
    If ((success <> 1) And (resp.StatusCode <= 0)) Then
        outFile.WriteLine("Remove schedule: HTTP request failed.")
        WScript.Quit
    End If

    If ((success <> 1) Or (resp.StatusCode <> 204)) Then
        outFile.WriteLine("Remove schedule: HTTP " & resp.StatusCode & " " & resp.BodyStr)
        WScript.Quit
    End If

    outFile.WriteLine("Schedule removed for activity " & activityId)
    WScript.Quit
End If

If (action <> "schedule") Then
    outFile.WriteLine("Choose schedule or unschedule.")
    WScript.Quit
End If

'  Replace the placeholder with the intended future delivery time, e.g. 2030-05-15T09:00:00-05:00.
deliveryTime = "ENTER_FUTURE_TIMESTAMP_WITH_OFFSET"
set delivery = CreateObject("Chilkat.CkDateTime")
set now = CreateObject("Chilkat.CkDateTime")
success = now.SetFromCurrentSystemTime()
success = delivery.SetFromTimestamp(deliveryTime)
If ((success <> 1) Or (delivery.DiffSeconds(now) <= 0)) Then
    outFile.WriteLine("Enter a valid future delivery time with a UTC offset or Z.")
    WScript.Quit
End If

'  Use the full display name. AddParam encodes spaces and punctuation.
listName = "Workshop announcements"
set query = CreateObject("Chilkat.HttpRequest")
query.HttpVerb = "GET"
query.AddParam "name",listName
query.AddParam "status","active"
query.AddParam "include_membership_count","active"
success = http.HttpReq("https://api.cc.email/v3/contact_lists",query,resp)
If ((success <> 1) And (resp.StatusCode <= 0)) Then
    outFile.WriteLine("Look up list: HTTP request failed.")
    WScript.Quit
End If

If ((success <> 1) Or (resp.StatusCode <> 200)) Then
    outFile.WriteLine("Look up list: HTTP " & resp.StatusCode & " " & resp.BodyStr)
    WScript.Quit
End If

set matches = CreateObject("Chilkat.JsonObject")
success = matches.Load(resp.BodyStr)
If (success <> 1) Then
    outFile.WriteLine("Expected a JSON object in the response.")
    WScript.Quit
End If

If (matches.SizeOfArray("lists") = 0) Then
    outFile.WriteLine("No active email list named " & listName)
    WScript.Quit
End If

If ((matches.SizeOfArray("lists") <> 1) Or (matches.StringOfEquals("lists[0].name",listName,1) <> 1)) Then
    outFile.WriteLine("Expected one exact list name.")
    WScript.Quit
End If

listId = matches.StringOf("lists[0].list_id")
If (listId = "") Then
    outFile.WriteLine("Missing list ID.")
    WScript.Quit
End If

outFile.WriteLine(listName & " | List ID: " & listId & " | Mailable contacts: " & matches.IntOf("lists[0].membership_count"))

'  PUT replaces the activity. Read it first to preserve the subject, sender and other settings.
'  Constant Contact retains omitted subresources such as html_content and the physical footer.
success = http.HttpNoBody("GET","https://api.cc.email/v3/emails/activities/{$activity}",resp)
If ((success <> 1) And (resp.StatusCode <= 0)) Then
    outFile.WriteLine("Read draft: HTTP request failed.")
    WScript.Quit
End If

If ((success <> 1) Or (resp.StatusCode <> 200)) Then
    outFile.WriteLine("Read draft: HTTP " & resp.StatusCode & " " & resp.BodyStr)
    WScript.Quit
End If

set draft = CreateObject("Chilkat.JsonObject")
success = draft.Load(resp.BodyStr)
If (success <> 1) Then
    outFile.WriteLine("Expected a JSON object in the response.")
    WScript.Quit
End If

If ((draft.StringOfEquals("role","primary_email",1) <> 1) Or (draft.StringOfEquals("current_status","DRAFT",1) <> 1)) Then
    outFile.WriteLine("Select a primary activity in DRAFT status.")
    WScript.Quit
End If

outFile.WriteLine("LIVE SEND: " & draft.StringOf("subject") & " | Activity: " & activityId & " | List: " & listName & " | Delivery: " & deliveryTime)
success = draft.UpdateNewArray("contact_list_ids")
success = draft.UpdateString("contact_list_ids[0]",listId)
success = draft.UpdateNewArray("segment_ids")
success = http.HttpJson("PUT","https://api.cc.email/v3/emails/activities/{$activity}",draft,"application/json",resp)
If ((success <> 1) And (resp.StatusCode <= 0)) Then
    outFile.WriteLine("Assign audience: HTTP request failed.")
    WScript.Quit
End If

If ((success <> 1) Or (resp.StatusCode <> 200)) Then
    outFile.WriteLine("Assign audience: HTTP " & resp.StatusCode & " " & resp.BodyStr)
    WScript.Quit
End If

set updated = CreateObject("Chilkat.JsonObject")
success = updated.Load(resp.BodyStr)
If (success <> 1) Then
    outFile.WriteLine("Expected a JSON object in the response.")
    WScript.Quit
End If

If ((updated.SizeOfArray("contact_list_ids") <> 1) Or (updated.StringOfEquals("contact_list_ids[0]",listId,1) <> 1) Or (updated.SizeOfArray("segment_ids") > 0)) Then
    outFile.WriteLine("The saved audience did not match the requested list. Scheduling stopped.")
    WScript.Quit
End If

set schedule = CreateObject("Chilkat.JsonObject")
success = schedule.UpdateString("scheduled_date",delivery.GetAsTimestamp(0))
success = http.HttpJson("POST","https://api.cc.email/v3/emails/activities/{$activity}/schedules",schedule,"application/json",resp)
If ((success <> 1) Or (resp.StatusCode < 200) Or (resp.StatusCode >= 300)) Then
    outFile.WriteLine("Schedule not confirmed. HTTP " & resp.StatusCode)
    outFile.WriteLine("The audience was saved. Check the schedule before retrying.")
    WScript.Quit
End If

outFile.WriteLine("Live delivery scheduled for " & schedule.StringOf("scheduled_date") & " to " & listName)

outFile.Close