---
title: "Processes a request create action"
method: POST
path: "/v1.0/requests"
tags: ["Requests"]
---

# Processes a request create action

`POST /v1.0/requests`

## Query parameters

- `accountId` integer

## Request body

- RequestCreateActionProcessDTO — The request create action body
  - `requestCreateActionType` 'ORGANISATION_ACCOUNT_OPENING_SUBMIT_APPLICATION' | 'NOTIFICATION_OF_COMPLIANCE_P3' | 'RE_INITIATE_NOTIFICATION_OF_COMPLIANCE_P3' | 'ACTION_PLAN_P3' | 'RE_INITIATE_ACTION_PLAN_P3' | 'ACCOUNT_CLOSURE' | 'PROGRESS_UPDATE_1_P3' | 'RE_INITIATE_PROGRESS_UPDATE_1_P3' | 'PROGRESS_UPDATE_2_P3' | 'RE_INITIATE_PROGRESS_UPDATE_2_P3', required
  - `requestCreateActionPayload` union, required
    - OrganisationAccountOpeningSubmitApplicationCreateActionPayload
      - `payloadType` 'ORGANISATION_ACCOUNT_OPENING_SUBMIT_APPLICATION_PAYLOAD' | 'REPORT_RELATED_REQUEST_CREATE_ACTION_PAYLOAD' | 'EMPTY_PAYLOAD' | 'PROGRESS_UPDATE_1_CREATE_ACTION_PAYLOAD' | 'PROGRESS_UPDATE_2_CREATE_ACTION_PAYLOAD'
      - `registrationNumber` string
      - `name` string, required
      - `competentAuthority` 'ENGLAND' | 'NORTHERN_IRELAND' | 'OPRED' | 'SCOTLAND' | 'WALES', required
      - `line1` string, required
      - `line2` string
      - `city` string, required
      - `county` string
      - `postcode` string, required
      - `type` 'SIC' | 'OTHER', required
      - `otherTypeName` string
      - `codes` string[], required
    - ProgressUpdate1RequestCreateActionPayload
      - `payloadType` 'ORGANISATION_ACCOUNT_OPENING_SUBMIT_APPLICATION_PAYLOAD' | 'REPORT_RELATED_REQUEST_CREATE_ACTION_PAYLOAD' | 'EMPTY_PAYLOAD' | 'PROGRESS_UPDATE_1_CREATE_ACTION_PAYLOAD' | 'PROGRESS_UPDATE_2_CREATE_ACTION_PAYLOAD'
      - `isDisaggregateUndertaking` boolean, required
    - ProgressUpdate2RequestCreateActionPayload
      - `payloadType` 'ORGANISATION_ACCOUNT_OPENING_SUBMIT_APPLICATION_PAYLOAD' | 'REPORT_RELATED_REQUEST_CREATE_ACTION_PAYLOAD' | 'EMPTY_PAYLOAD' | 'PROGRESS_UPDATE_1_CREATE_ACTION_PAYLOAD' | 'PROGRESS_UPDATE_2_CREATE_ACTION_PAYLOAD'
      - `isDisaggregateUndertaking` boolean, required
    - ReportRelatedRequestCreateActionPayload
      - `payloadType` 'ORGANISATION_ACCOUNT_OPENING_SUBMIT_APPLICATION_PAYLOAD' | 'REPORT_RELATED_REQUEST_CREATE_ACTION_PAYLOAD' | 'EMPTY_PAYLOAD' | 'PROGRESS_UPDATE_1_CREATE_ACTION_PAYLOAD' | 'PROGRESS_UPDATE_2_CREATE_ACTION_PAYLOAD'
      - `requestId` string, required
    - RequestCreateActionEmptyPayload
      - `payloadType` 'ORGANISATION_ACCOUNT_OPENING_SUBMIT_APPLICATION_PAYLOAD' | 'REPORT_RELATED_REQUEST_CREATE_ACTION_PAYLOAD' | 'EMPTY_PAYLOAD' | 'PROGRESS_UPDATE_1_CREATE_ACTION_PAYLOAD' | 'PROGRESS_UPDATE_2_CREATE_ACTION_PAYLOAD'

## Response `200`

OK

- RequestCreateActionProcessResponseDTO
  - `requestId` string

## Other responses

- `400` — Bad Request Error Code | Description FORM1001 | Form validation failed REQUEST_CREATE_ACTION1000 | Request create action not allowed ACCOUNT1001 | Account registration number already exists
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service unavailable Error Code | Description COMPANYINFO1001 | Companies House API is currently unavailable COMPANYINFO1002 | Companies House API authorization failed COMPANYINFO1003 | Companies House API rate limiting reached

---

[API](https://skmtc.net/beis/apis/esos-api-documentation.md) · [All operations](https://skmtc.net/beis/apis/esos-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beis/esos-api-documentation/revisions/aa4310e86ddd/schema)