---
title: "createCaseEvent"
method: POST
path: "/cases/{caseId}/events"
tags: ["case-endpoint"]
---

# createCaseEvent

`POST /cases/{caseId}/events`

## Request

- Base URL: `https://localhost:8171`
- URL: `https://localhost:8171/cases/{caseId}/events`
- Auth: none declared

creates a case event

## Path parameters

- `caseId` string, required

## Request body

- CaseEventCreationRequestDTO
  - `category` 'ACCESS_CODE_AUTHENTICATION_ATTEMPT' | 'ACTION_CANCELLATION_COMPLETED' | 'ACTION_CANCELLATION_CREATED' | 'ACTION_COMPLETED' | 'ACTION_CREATED' | 'ACTION_UPDATED' | 'ADDRESS_OCCUPIED_NO_RESIDENT' | 'CASE_CREATED' | 'COLLECTION_INSTRUMENT_DOWNLOADED' | 'COLLECTION_INSTRUMENT_ERROR' | 'COMPLETED_BY_PHONE' | 'COMPLY_IN_DIFFERENT_COLLECTION_MODE' | 'DISABLE_RESPONDENT_ENROLMENT' | 'EQ_LAUNCH' | 'GENERATE_ENROLMENT_CODE' | 'LACK_OF_COMPUTER_INTERNET_ACCESS' | 'NO_ACTIVE_ENROLMENTS' | 'NO_LONGER_REQUIRED' | 'OFFLINE_RESPONSE_PROCESSED' | 'ONLINE_QUESTIONNAIRE_RESPONSE' | 'PHYSICALLY_OR_MENTALLY_UNABLE' | 'PRIVACY_DATA_CONFIDENTIALITY_CONCERNS' | 'RESPONDENT_ACCOUNT_CREATED' | 'RESPONDENT_EMAIL_AMENDED' | 'RESPONDENT_ENROLED' | 'SECURE_MESSAGE_SENT' | 'SUCCESSFUL_RESPONSE_UPLOAD' | 'UNSUCCESSFUL_RESPONSE_UPLOAD' | 'VERIFICATION_CODE_SENT', required
  - `createdBy` string, required
  - `description` string, required
  - `subCategory` string
  - `metadata` object

## Response `200`

OK

- CreatedCaseEventDTO
  - `caseId` string
  - `category` 'ACTION_CANCELLATION_COMPLETED' | 'ACTION_CANCELLATION_CREATED' | 'ACTION_COMPLETED' | 'ACTION_CREATED' | 'ACTION_UPDATED' | 'ADDRESS_OCCUPIED_NO_RESIDENT' | 'CASE_CREATED' | 'COLLECTION_INSTRUMENT_DOWNLOADED' | 'COLLECTION_INSTRUMENT_ERROR' | 'COMPLETED_BY_PHONE' | 'COMPLY_IN_DIFFERENT_COLLECTION_MODE' | 'DISABLE_RESPONDENT_ENROLMENT' | 'EQ_LAUNCH' | 'GENERATE_ENROLMENT_CODE' | 'LACK_OF_COMPUTER_INTERNET_ACCESS' | 'NO_ACTIVE_ENROLMENTS' | 'NO_LONGER_REQUIRED' | 'OFFLINE_RESPONSE_PROCESSED' | 'ONLINE_QUESTIONNAIRE_RESPONSE' | 'PHYSICALLY_OR_MENTALLY_UNABLE' | 'PRIVACY_DATA_CONFIDENTIALITY_CONCERNS' | 'RESPONDENT_ACCOUNT_CREATED' | 'RESPONDENT_EMAIL_AMENDED' | 'RESPONDENT_ENROLED' | 'SECURE_MESSAGE_SENT' | 'SUCCESSFUL_RESPONSE_UPLOAD' | 'UNSUCCESSFUL_RESPONSE_UPLOAD' | 'VERIFICATION_CODE_SENT'
  - `createdBy` string
  - `createdDateTime` string, date-time
  - `description` string
  - `metadata` object
  - `partyId` string
  - `subCategory` string

## Other responses

- `201`: Created
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2021-10-28** `803bfe28d21e`: 1 warning, 1 info
  - added the new `RESPONDENT_EMAIL_AMENDED` enum value to the `category` response property for the response status `200`
  - added the new `RESPONDENT_EMAIL_AMENDED` enum value to the request property `category`
- **2021-10-28** `48b735d77a07`: 4 breaking, 4 info
  - removed the enum value `LANGUAGE_DIFFICULTIES` of the request property `category`
  - removed the enum value `NON_RESIDENTIAL_ADDRESS` of the request property `category`
  - removed the enum value `RESPONDENT_EMAIL_AMENDED` of the request property `category`
  - removed the enum value `TOO_BUSY` of the request property `category`
  - …4 more
- **2021-07-27** `c0689468d20f`: 18 breaking, 18 info
  - removed the enum value `COMMUNAL_ESTABLISHMENT_INSTITUTION` of the request property `category`
  - removed the enum value `DECEASED` of the request property `category`
  - removed the enum value `DWELLING_OF_FOREIGN_SERVICE_PERSONNEL_DIPLOMATS` of the request property `category`
  - removed the enum value `FULL_INTERVIEW_REQUEST_DATA_DELETED` of the request property `category`
  - …32 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/case-service-api/changes/cases/:caseId/events/post.md)

---

[API](https://skmtc.dev/office-of-national-statistics/apis/case-service-api.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/case-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/case-service-api/revisions/6523753b5522?raw)