HMRC Agent Credentials

The practice's sets of HMRC agent details: a Government Gateway login with the ARN, agent codes and agent contact that go with it. One set is the default, which MTD uses for the ARN; letter-based 64-8 requests use the set the practice picks. Passwords are write-only.

OpenAPI Spec

Guides Operations Schemas

GET List HmrcAgentCredentials
Lists all HmrcAgentCredentials for the given tenant.
/tenants/{tenant}/hmrc-credentials
POST Create HmrcAgentCredential
Creates a new HmrcAgentCredential for the specified tenant.
/tenants/{tenant}/hmrc-credentials
GET Get HmrcAgentCredential
Gets a HmrcAgentCredential for the specified tenant.
/tenants/{tenant}/hmrc-credentials/{code}
PUT Update HmrcAgentCredential
Updates a HmrcAgentCredential for the specified tenant.
/tenants/{tenant}/hmrc-credentials/{code}
DELETE Delete HmrcAgentCredential
Deletes a HmrcAgentCredential for the specified tenant.
/tenants/{tenant}/hmrc-credentials/{code}
GET List HMRC Agent Credential Options
Returns the code and name of each credential set, default first, for choosing which Government Gateway login makes a letter-based 64-8 request and for...
/tenants/{tenant}/hmrc-credentials/options
POST Make HMRC Agent Credential Default
Makes this set the default: MTD uses its ARN, and letter-based requests use it when no set is chosen.
/tenants/{tenant}/hmrc-credentials/{code}/make-default