Create a test user

Create a test user account for testing in the sandbox with user-restricted endpoints.

What is a test user?

A test user is a dummy Government Gateway account that you can use for testing in our sandbox.

To access user-restricted endpoints, your application’s users must complete the OAuth journey, which includes signing into their Government Gateway account.

Each test user has a:

type of Government Gateway account - individual, organisation or agent
Government Gateway user ID and password - for sign in during the OAuth journey
default set of service enrolments and related tax identifiers - as different APIs require different enrolments

What types of test user can I create?

You can create individuals or organisations with a default set of service enrolments and tax identifiers.

To create a wider range of test users, including agents, or if you are using automated testing, use the Create Test User API.

How long does a test user last?

Test users and other test data are cleared down every two weeks.

Choose a type

Individual

Creates a test user with a User ID, Password, Self Assessment UTR and National Insurance number.
Enrols them for Self Assessment and National Insurance.

Organisation

Creates a test user with a User ID, Password, Self Assessment UTR, Corporation Tax UTR, Employer Reference and VAT Registration Number.
Enrols them for Self Assessment, Corporation Tax, PAYE for Employers and Submit VAT Returns.

Get help with this page. Get help with this page.