---
title: "Send intake form emails to participants"
method: POST
path: "/cohorts/{cohortId}/intake/send"
tags: ["Intake"]
---

# Send intake form emails to participants

`POST /cohorts/{cohortId}/intake/send`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/cohorts/{cohortId}/intake/send`
- Auth: HTTP bearer

Send intake form invitation emails to participants.
If participant_ids is not provided, sends to all participants who haven't received the form yet.

Supported merge tags in subject and body:
- {{first_name}} - Participant's first name
- {{last_name}} - Participant's last name
- {{full_name}} - Participant's full name
- {{email}} - Participant's email
- {{cohort_name}} - Cohort name
- {{form_link}} or {{intake_form_link}} - Unique intake form URL

## Path parameters

- `cohortId` string, uuid, required

## Request body

- object
  - `form_id` string, required: Paperform form ID
  - `subject` string: Email subject (supports merge tags)
  - `body` string: Email body HTML (supports merge tags)
  - `participant_ids` string[]: Specific participant IDs to send to (optional)

## Response `200`

Intake emails sent successfully

- object
  - `success` boolean
  - `data` object
    - `sent` integer
    - `failed` integer
    - `errors` string[]
  - `message` string

## Other responses

- `400`: Invalid request or no participants to send to
- `401`: Unauthorized
- `404`: Cohort or form not found

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)