Skip to main content
HMRC Developer Hub

Your feedback (opens in new tab) will help us to improve this service.

Create a test user

A test user is a dummy HMRC online service user ID used for testing in the sandbox. This includes granting authority to your software to interact with our user-restricted endpoints.

A test user ID has:

  • a type - individual, organisation or agent
  • a password
  • a set of service enrolments and related tax identifiers needed for different APIs

You must use the Create Test User API to:

  • create a test user which is an agent
  • create a test user for use in automated testing
  • select individual service enrollments

You can create multiple test users which will be generated in a default test state.

Test users can be reused, so we recommend checking if you have any unused test users before creating a new one.

Test users that have not been used in testing for 90 days will be deleted.

Choose a type of test user

What dummy data is generated?

Creates a test user with a:

  • User ID
  • Password
  • Self Assessment UTR
  • National Insurance Number (NINO)
  • VAT Registration Number
  • Economic Operator Registration and Identification (EORI) number
  • Full Name
  • Email Address
  • Making Tax Digital Income Tax ID
  • VAT Registration Date
  • Group Identifier

Enrols them for all services available through the relevant Create Test User API endpoint.

What dummy data is generated?

Creates a test user with a:

  • User ID
  • Password
  • Self Assessment UTR
  • National Insurance Number (NINO)
  • VAT Registration Number
  • Employer Reference
  • Corporation Tax UTR
  • Economic Operator Registration and Identification (EORI) number
  • Full Name
  • Email Address
  • Making Tax Digital Income Tax ID
  • VAT Registration Date
  • LISA Manager Reference Number
  • Secure Electronic Transfer reference number
  • Pension Scheme Administrator Identifier
  • Group Identifier

Enrols them for all services available through the relevant Create Test User API endpoint.

Is this page not working properly? (opens in new tab)