# POST /lead-gen/initiatives

**Resource:** [Lead Gen Initiatives](./lead-gen-initiatives.md)  
**MCP tool:** `lead_gen_create_initiative`  
**Scopes:** `lead-gen:write`  
**Write operation:** yes

Create an outreach initiative (multi-step sequence) for lead-gen leads. Send-cadence fields are optional — sensible defaults apply (40 emails/day, 09:00-17:00 Mon-Fri Sydney, 90s minimum gap). Override only if the user needs a specific pace.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `name` | body | string | yes |  |
| `description` | body | string | no |  |
| `is_active` | body | boolean | no | Active initiatives run their dispatcher; paused initiatives queue no new sends. Default true. |
| `daily_send_cap` | body | integer | no | Max email-channel sends per calendar day in the initiative timezone. Default 40. Personal email accounts typically get flagged above ~50/day for cold outreach. |
| `send_window_start` | body | string | no | 24-hour HH:MM start of the daily send window in send_window_timezone. Default "09:00". |
| `send_window_end` | body | string | no | 24-hour HH:MM end of the daily send window in send_window_timezone. Default "17:00". |
| `send_window_timezone` | body | string | no | IANA timezone for the send window (e.g. "Australia/Sydney"). Default "Australia/Sydney". |
| `send_window_days` | body | array | no | ISO weekdays the initiative is allowed to send on (1=Mon … 7=Sun). Default [1,2,3,4,5] (weekdays). |
| `min_gap_seconds` | body | integer | no | Minimum seconds between consecutive successful sends on this initiative. Default 90 — spreads 40 sends across ~60 minutes minimum. |
| `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/lead-gen/initiatives"   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"name":"...","description":"...","is_active":"..."}'
```

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