API Docs / Operations / Client - Agent Authorisations / Submit Letter Auth Code

Submit Letter Auth Code

POST /tenants/{tenant}/clients/{client}/agent-authorisations/hmrc-submit-code

Submits the authorisation code that HMRC posted to the client (letter-based SA, CT, PAYE/CIS flow). On success the authorisation status is set to Granted.

Parameters

NameTypeDescription
tenant* path string

The Tenant.Code

The Tenant.Code

client* path string
{
  "authorisationType": "SelfAssessment",
  "authorisationCode": "string"
}

Responses

204 No Content
400 Bad Request
401 Unauthorized – Invalid or missing API key
404 Not Found