# POST /lead-gen/initiatives/:id/enrol

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

Enrol one or more search results into an outreach initiative. Each enrolment tracks progress through the initiative's steps. Leads already enrolled in this initiative are skipped (idempotent). Unsubscribed leads are silently excluded.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Initiative UUID |
| `search_result_ids` | body | array | yes | Array of search result UUIDs to enrol |
| `assigned_user_id` | body | uuid | no | User whose Gmail connection to use for email steps. Defaults to the API key owner. |

## Request example

```bash
curl -X POST \
  "https://api.trustpager.com/functions/v1/api/v1/lead-gen/initiatives/a1b2c3d4-.../enrol" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search_result_ids":["r1...","r2...","r3..."]}'
```

## Response example

```json
{
  "enrolled": 3,
  "skipped_already_enrolled": 0,
  "skipped_unsubscribed": 0,
  "enrolment_ids": ["e1...","e2...","e3..."]
}
```

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