Create Tenant

POST /tenants

Creates a tenant owned by the caller, with the given name, VAT status and modules; its email address and phone number start as the caller's. A contractor tenant of a user who manages several tenants adopts the user's first shared HMRC credentials.

Request Body*

CreateTenantRequest

{
  "name": "string",
  "isVatRegistered": false,
  "vatRegistrationNumber": "string",
  "modules": [
    "CisContractor"
  ]
}

Responses

201 Created

TenantDto

400 Bad Request

HttpValidationProblemDetails

application/problem+json

401 Unauthorized – Invalid or missing API key

ProblemDetails