---
title: "Create Test Organisation"
method: POST
path: "/organisations/pillar-two/setup/organisation"
tags: ["setup"]
---

# Create Test Organisation

`POST /organisations/pillar-two/setup/organisation`

Creates a test organisation associated with your authorised organisation.

## Headers

- `Authorization` string, required
- `X-Pillar2-Id` string, required
- `Accept` string

## Request body

- object
  - `orgDetails` object, required — Contains information about an organisation that is registered to Pillar 2.
    - `domesticOnly` boolean, required — Specifies whether a group only operates in the UK, or whether it has any companies within it which operate abroad. For a company that is registered in the UK but has offices which are based abroad, the value will be `false`.
    - `organisationName` string, required — The full name of a company registered on Pillar 2.
    - `registrationDate` string, date, required — The date that a group successfully registers and subscribes to Pillar 2 with HMRC.
  - `accountingPeriod` object, required — The period in which a group would be submitting their Pillar 2 returns to HMRC. This period of time varies amongst different businesses. It is effectively their "business year", and is expected to be the same as their accounting period with Pillar 2.
    - `startDate` string, date, required — The start date of the accounting period.
    - `endDate` string, date, required — The end date of the accounting period.
    - `underEnquiry` boolean, nullable — Specifies whether an HMRC enquiry into the group is underway. The group will have been notified before the enquiry begins. If a group is under enquiry, then the value will be `true`. In this time period, amendments to a UKTR and submission of a BTN may not be processed depending on the outcome of the enquiry.
  - `testData` object
    - `accountActivityScenario` 'DTT_CHARGE' | 'FULLY_PAID_CHARGE' | 'FULLY_PAID_CHARGE_WITH_SPLIT_PAYMENTS' | 'REPAYMENT_INTEREST' | 'DTT_DETERMINATION' | 'DTT_IIR_UTPR' | 'ACCRUED_INTEREST' | 'DTT_IIR_UTPR_INTEREST' | 'DTT_IIR_UTPR_DETERMINATION' | 'DTT_IIR_UTPR_DISCOVERY' | 'DTT_IIR_UTPR_OVERPAID_CLAIM' | 'UKTR_DTT_UKTR_MTT_LATE_FILING_PENALTY' | 'ORN_GIR_DTT_UKTR_MTT_LATE_FILING_PENALTY' | 'POTENTIAL_LOST_REVENUE_PENALTY' | 'SCHEDULE_36_PENALTY' | 'RECORD_KEEPING_PENALTY' | 'REPAYMENT_CREDIT' | 'INTEREST_REPAYMENT_CREDIT' | 'COMBINED_REPAYMENT', required

## Response `201`

Test Organisation Created

- object
  - `pillar2Id` string, required — A unique identifier for Pillar 2. Each company will have a different ID, allocated by HMRC.
  - `organisation` object, required
    - `orgDetails` object, required — Contains information about an organisation that is registered to Pillar 2.
      - `domesticOnly` boolean, required — Specifies whether a group only operates in the UK, or whether it has any companies within it which operate abroad. For a company that is registered in the UK but has offices which are based abroad, the value will be `false`.
      - `organisationName` string, required — The full name of a company registered on Pillar 2.
      - `registrationDate` string, date, required — The date that a group successfully registers and subscribes to Pillar 2 with HMRC.
    - `accountingPeriod` object, required — The period in which a group would be submitting their Pillar 2 returns to HMRC. This period of time varies amongst different businesses. It is effectively their "business year", and is expected to be the same as their accounting period with Pillar 2.
      - `startDate` string, date, required — The start date of the accounting period.
      - `endDate` string, date, required — The end date of the accounting period.
      - `underEnquiry` boolean, nullable — Specifies whether an HMRC enquiry into the group is underway. The group will have been notified before the enquiry begins. If a group is under enquiry, then the value will be `true`. In this time period, amendments to a UKTR and submission of a BTN may not be processed depending on the outcome of the enquiry.
    - `testData` object
      - `accountActivityScenario` 'DTT_CHARGE' | 'FULLY_PAID_CHARGE' | 'FULLY_PAID_CHARGE_WITH_SPLIT_PAYMENTS' | 'REPAYMENT_INTEREST' | 'DTT_DETERMINATION' | 'DTT_IIR_UTPR' | 'ACCRUED_INTEREST' | 'DTT_IIR_UTPR_INTEREST' | 'DTT_IIR_UTPR_DETERMINATION' | 'DTT_IIR_UTPR_DISCOVERY' | 'DTT_IIR_UTPR_OVERPAID_CLAIM' | 'UKTR_DTT_UKTR_MTT_LATE_FILING_PENALTY' | 'ORN_GIR_DTT_UKTR_MTT_LATE_FILING_PENALTY' | 'POTENTIAL_LOST_REVENUE_PENALTY' | 'SCHEDULE_36_PENALTY' | 'RECORD_KEEPING_PENALTY' | 'REPAYMENT_CREDIT' | 'INTEREST_REPAYMENT_CREDIT' | 'COMBINED_REPAYMENT', required
    - `lastUpdated` string, date-time, required

## Other responses

- `400` — Invalid Request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Organisation Already Exists
- `500` — Internal Server Error

---

[API](https://skmtc.net/hmrc/apis/pillar2-submission-api.md) · [All operations](https://skmtc.net/hmrc/apis/pillar2-submission-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hmrc/pillar2-submission-api/revisions/aaa66491fee8/schema)