---
title: "Create credential pool"
method: POST
path: "/api/v1/credentials/"
tags: ["credentials"]
---

# Create credential pool

`POST /api/v1/credentials/`

Create a new workspace-level credential pool. Credential pools contain username/password pairs that can be assigned to participants when they start a study. This allows researchers to provide pre-provisioned credentials for third-party platforms.
The credentials are provided as a CSV string where each line contains a username and password separated by a comma (e.g., "user1,pass1\nuser2,pass2").

## Headers

- `Authorization` string, required

## Request body

- object
  - `credentials` string, required — CSV-formatted credentials (username,password per line)
  - `workspace_id` string, required — The ID of the workspace this credential pool belongs to

## Response `201`

Credential pool created successfully

- CredentialsCreateCredentialPoolResponse201
  - `credential_pool_id` string — The unique identifier for the created credential pool

## Other responses

- `400` — Error
- `403` — Forbidden - User does not have workspace.workspace_update permission
- `409` — Conflict - Duplicate credentials detected (username already exists in pool)
- `502` — Bad Gateway - Credentials service unavailable or internal error

---

[API](https://skmtc.net/prolific/apis/api-reference.md) · [All operations](https://skmtc.net/prolific/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prolific/api-reference/versions/dc6f073a9827/schema)