Schedule or launch campaign
Activate a campaign flow immediately or at a date and time.
POST https://cotlet.dev/api/v1/postscript/campaigns/{campaign_id}/schedule
write Confirm
Uses Schedule or Launch: Activate immediately starts the one-time flow now, Activate at a scheduled time and date starts it then. use_subscriber_time_zone sends at that local time in each region and works only for scheduled campaigns. Postscript holds campaign messages until waking hours in each subscriber's time zone. It sends texts to everyone in the Include segments. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| campaign_id string required | string | Campaign draft to activate. |
| starts_at datetime | datetime | Date and time to start. Leave out to activate immediately. |
| use_subscriber_time_zone boolean | boolean | Send at the given time in each subscriber's time zone. Default: false. |
Request
curl -X POST https://cotlet.dev/api/v1/postscript/campaigns/campaign_8c41d2/schedule \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("postscript", "schedule_campaign", {"campaign_id":"campaign_8c41d2"})const result = await cotlet.call('postscript', 'schedule_campaign', {"campaign_id":"campaign_8c41d2"});cotlet call postscript schedule_campaign --data '{"campaign_id":"campaign_8c41d2"}'Example response
{
"campaign_id": "f_51877",
"status": "scheduled",
"starts_at": "2026-10-28T11:00:00",
"use_subscriber_time_zone": true
}