---
title: "Create a respondent"
method: POST
path: "/respondents"
tags: ["respondents"]
---

# Create a respondent

`POST /respondents`

Create a respondent and set up pending enrolment before account verification

## Request body

- object
  - `emailAddress` string, email — The email address of the respondent
  - `firstName` string — The first name of the respondent
  - `lastName` string — The last name of the respondent
  - `password` string — The password of the respondent
  - `telephone` string — The telephone number of the respondent
  - `enrolmentCode` string — The enrolment code the respondent is using

## Response `200`

The respondent has been created

- RespondentWithAssociations
  - `id` string, uuid
  - `sampleUnitType` string
  - `pendingEmailAddress` string, email
  - `firstName` string
  - `lastName` string
  - `telephone` string
  - `status` 'CREATED' | 'ACTIVE' | 'SUSPENDED'
  - `markForDeletion` boolean
  - `passwordVerificationToken` string
  - `passwordResetCounter` integer
  - `associations` Association[]
    - `partyId` string, uuid
    - `sampleUnitRef` string, string
    - `businessRespondentStatus` 'CREATED' | 'ACTIVE' | 'SUSPENDED'
    - `enrolments` Enrolment[]
      - `surveyId` string, uuid
      - `enrolmentStatus` 'PENDING' | 'ENABLED' | 'DISABLED' | 'SUSPENDED'

## Other responses

- `400` — There was an error in the request body, or the enrolment code was inactive
- `409` — The email address is already in use
- `500` — The business couldn't be found to associate with, or one of the other services had an error

---

[API](https://skmtc.net/office-of-national-statistics/apis/party-service-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/party-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/party-service-api/revisions/a9abfd072409/schema)