# POST /email-campaigns/:campaign_id/schedule

**Resource:** [Email Campaigns](./email-campaigns.md)  
**MCP tool:** `schedule_email_blast_run`  
**Scopes:** `email-blasts:write`  
**Write operation:** yes

Schedule a run of an email blast for a future time, or immediately. Creates a scheduled run that appears in the blast's Runs list and snapshots the blast's current subject, body, CTA and audience filter, so editing the blast afterwards does not change what this run sends. Omit scheduled_for (or pass a past time) to send as soon as possible. The audience is re-resolved when the run fires, so contacts added between scheduling and sending are included. Costs credits per recipient at fire time. Edit a scheduled run with update_email_blast_run, or cancel it with cancel_email_blast_run.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `campaign_id` | path | string | yes |  |
| `scheduled_for` | body | string | no | ISO 8601 instant to send at, e.g. 2026-08-07T01:00:00Z. This is an absolute moment, not a local wall-clock time, so convert from the workspace timezone first. Omit to send now. |
| `paused` | body | boolean | no | Create the run PAUSED: it keeps its content, audience and intended send time but is not queued, so it cannot fire until someone arms it with resume_email_blast_run. Use this when a send needs sign-off before it goes out. Defaults to false. |
| `require_approval` | body | boolean | no | Optional. Set true to route this write into the approval queue for human review instead of executing it immediately (returns 202 + an approval_id). Works even when your key/token has permission to execute directly. |

## Request example

```bash
curl -X POST   "https://api.trustpager.com/functions/v1/api/v1/email-campaigns/:campaign_id/schedule"   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"scheduled_for":"...","paused":"..."}'
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`