---
title: "Create a test user which is an organisation"
method: POST
path: "/create-test-user/organisations"
tags: ["create-test-user"]
---

# Create a test user which is an organisation

`POST /create-test-user/organisations`

This resource creates and returns a test user which is an organisation. The caller can specify the required service enrolments in the request body. If no request body is supplied, the test user is created with no service enrolments.  Test users that have not been tested against within a 3-month period will be automatically deleted.

## Request body

- object — Create Organisation Request
  - `eoriNumber` string — Economic Operator Registration and Identification (EORI) number. Regular expressions:<br><code>^(GB|XI)[0-9]{12,15}$</code> A GB or XI EORI.<br><code>^[A-Z]{2}[0-9]{1,15}$</code> An EU EORI.
  - `exciseNumber` string — Excise Number. Must be enrolled with 'excise-movement-control-system' for this to be used
  - `nino` string — National Insurance number. Must be enrolled with 'national-insurance' or 'mtd-income-tax' services for this to be used.
  - `taxPayerType` string — Type of Self Assessment taxpayer One of 'Individual' or 'Partnership'
  - `pillar2Id` string — A Pillar 2 ID can be provided for the test organisation
  - `zReference` string — An ISA Manager Z Reference can be provided for the test organisation

## Response `201`

The organisation test user resource has been created.

- object — Create Organisation Response
  - `userId` string, required — Government Gateway ID.
  - `password` string, required — Government Gateway password.
  - `userFullName` string, required — Government Gateway user's full name.
  - `emailAddress` string, required — Government Gateway user's email address.
  - `organisationDetails` object, required
    - `name` string, required — Organisation name.
    - `address` object, required
      - `line1` string, required — Organisation's first line of address.
      - `line2` string, required — Organisation's second line of address.
      - `postcode` string, required — Organisation's postcode.
  - `individualDetails` object
    - `firstName` string, required — Individual's first name.
    - `lastName` string, required — Individual's last name.
    - `dateOfBirth` string, date, required — Individual's date of birth.
    - `address` object, required
      - `line1` string, required — Individual's first line of address.
      - `line2` string, required — Individual's second line of address.
      - `postcode` string, required — Individual's postcode.
  - `saUtr` string — Self Assessment UTR.
  - `nino` string — National Insurance number.
  - `mtdItId` string — Making Tax Digital Income Tax ID.
  - `empRef` string — Employer Reference.
  - `ctUtr` string — Corporation Tax UTR.
  - `vrn` string — VAT Reference Number.
  - `vatRegistrationDate` string, date — Date of registration for VAT.
  - `lisaManagerReferenceNumber` string — LISA Manager Reference Number, in either 4-digit format (Znnnn) or 6-digit format (Znnnnnn).
  - `secureElectronicTransferReferenceNumber` string — Secure Electronic Transfer reference number.
  - `pensionSchemeAdministratorIdentifier` string — Pension Scheme Administrator Identifier.
  - `eoriNumber` string — Economic Operator Registration and Identification (EORI) number.
  - `exciseNumber` string — Excise Number.
  - `crn` string — Company Reference Number
  - `taxPayerType` string — Type of Self Assessment taxpayer One of 'Individual' or 'Partnership'
  - `pillar2Id` string — Pillar 2 ID
  - `zReference` string — ISA Manager Z Reference, in 4-digit format (Znnnn).

---

[API](https://skmtc.dev/hmrc/apis/api-platform-test-user.md) · [All operations](https://skmtc.dev/hmrc/apis/api-platform-test-user/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hmrc/api-platform-test-user/revisions/14d026fe1251/schema)