---
title: "Add study participants"
method: POST
path: "/v1/studies/{study_id}/participants"
tags: ["Studies"]
---

# Add study participants

`POST /v1/studies/{study_id}/participants`

Adds candidates to a study as shortlisted participants. Skips candidates that are ineligible, uncontactable, inaccessible to the caller, or already participating.

## Path parameters

- `study_id` integer, required

## Request body

- object
  - `candidate_ids` integer[], required — IDs of existing candidates to add as shortlisted participants

## Response `201`

created

- object
  - `data` object
    - `added` integer
    - `already_participating` integer
    - `skipped_inaccessible` integer
    - `skipped_uncontactable` integer
    - `skipped_ineligible` integer

## Other responses

- `404` — study in another account
- `422` — candidate_ids missing

---

[API](https://skmtc.dev/greatquestion/apis/api-reference-v1.md) · [All operations](https://skmtc.dev/greatquestion/apis/api-reference-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greatquestion/api-reference-v1/revisions/f263ec4858a6/schema)