> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.prolific.com/api-reference/participant-groups/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.prolific.com/_mcp/server.

# Participant Groups

Participant groups are saved groups of participant IDs, so you can re-contact the exact same
participants across studies. They are dynamic in nature, so you can add and remove participants from the group on the fly and
any studies published with a participant group allowlist or participant group blocklist filter will be updated automatically.
Participant groups allow you do the following:

* Create a new participant group within the scope of a project.
* Add and remove users manually to / from the participant group.
* Use one or more participant groups as allowlist or blocklist filters for a new study.
* Combined with study completion codes, automatically add or remove participants from a group
  when they submit a response to your study with the correct code.
* Any participants added to or removed from the participant group on the fly will be automatically
  eligible or ineligible for studies that use a participant group allowlist or blocklist filter.


## API Docs

- Participant Groups [Get a list of all participant groups within a project or workspace](https://docs.prolific.com/api-reference/participant-groups/get-participant-groups.md)
- Participant Groups [Create a new participant group within a workspace](https://docs.prolific.com/api-reference/participant-groups/create-participant-group.md)
- Participant Groups [Get a participant group](https://docs.prolific.com/api-reference/participant-groups/get-participant-group.md)
- Participant Groups [Delete a participant group](https://docs.prolific.com/api-reference/participant-groups/delete-participant-group.md)
- Participant Groups [Update a participant group](https://docs.prolific.com/api-reference/participant-groups/update-participant-group.md)
- Participant Groups [Get a list of all participants within a participant group](https://docs.prolific.com/api-reference/participant-groups/get-participant-group-participants.md)
- Participant Groups [Add participants to a participant group](https://docs.prolific.com/api-reference/participant-groups/add-to-participant-group.md)
- Participant Groups [Remove participants from a participant group](https://docs.prolific.com/api-reference/participant-groups/remove-from-participant-group.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.prolific.com/api-reference/participant-groups/openapi.json)
- [OpenAPI YAML](https://docs.prolific.com/api-reference/participant-groups/openapi.yaml)