v1

latestOpenAPI 3.0.32026-07-131528298.7 KB
setup

Create Test Organisation

Creates a test organisation associated with your authorised organisation.

post/organisations/pillar-two/setup/organisation

Headers

Authorizationstring required

Bearer token for authentication

X-Pillar2-Idstring required

Pillar 2 Id - Pattern: [A-Z0-9]{1,15}

Acceptstring
Example:application/vnd.hmrc.1.0+json

Specifies the expected response format as versioned JSON from the HMRC API (v1.0). If not provided, it will default to application/vnd.hmrc.1.0+json.

Request body

Response

Test Organisation Created

pillar2Idstring required

A unique identifier for Pillar 2. Each company will have a different ID, allocated by HMRC.