# POST /lead-gen/initiatives

**Resource:** [Lead Generation](./lead-gen.md)  
**Scopes:** `lead-gen:write`  
**Write operation:** yes

Create a new outreach initiative (multi-step automated sequence). An initiative defines the name, goal, and optional daily send cap. Add steps via POST /lead-gen/initiatives/:id/steps, then enrol leads via POST /lead-gen/initiatives/:id/enrol.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `name` | body | string | yes | Initiative display name |
| `description` | body | string | no | Internal description of this outreach goal |
| `daily_send_cap` | body | integer | no | Max outreach actions per day across all enrolments (default: no cap beyond per-user limits) |
| `status` | body | string | no | Initial status: draft (default) or active |

## 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":"Q3 Roofing Outreach","description":"Multi-touch email + SMS sequence","status":"draft"}'
```

## Response example

```json
{
  "id": "a1b2c3d4-...",
  "name": "Q3 Roofing Outreach",
  "description": "Multi-touch email + SMS sequence",
  "status": "draft",
  "daily_send_cap": null,
  "step_count": 0,
  "enrolment_count": 0,
  "created_at": "2026-05-01T10:00:00Z"
}
```

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