How to Link MTD Software to HMRC Without Losing a Day
Step-by-step guide to authorising your MTD software with HMRC. No jargon, no wasted afternoon. Get linked and submit your first quarterly update today.
The authorisation screen has been staring at you for twenty minutes. You picked the software, you paid for it, and now HMRC wants you to prove the two of them are allowed to talk to each other. Here is exactly how to link MTD software to HMRC, what goes wrong when people rush it, and why the process is slightly more bureaucratic than it needs to be.
- Linking MTD software to HMRC requires a Government Gateway ID with the correct Self Assessment enrolment, not just any login.
- The authorisation window expires after 10 minutes inside HMRC's portal, so have your credentials ready before you start.
- If your software shows 'authorisation failed', the most common cause is a mismatched UTR rather than a technical fault.
- You only need to complete the authorisation once per software product; it does not expire unless you revoke it manually or switch tools.
- MTD for Income Tax applies from April 2026 for sole traders earning above £50,000, so linking now gives you time to test before it matters.
- MTD Software Authorisation
- The process by which HMRC grants a piece of Making Tax Digital software permission to read and submit data on your behalf via the HMRC API. It requires you to log in to Government Gateway and explicitly approve the connection, similar to granting an app access to your Google account.
Why Linking Feels Harder Than It Should
HMRC does not host your accounting data. It never has. What MTD does is require your software to send structured quarterly summaries directly to HMRC's servers via an Application Programming Interface (API). Before that can happen, HMRC needs your explicit consent on record. Fair enough.
The problem is that HMRC's authorisation journey was designed by people who spend their days inside Government Gateway, not by a plumber who has already spent forty minutes trying to remember which email address he used to register in 2019. The redirect loops, the session timeouts, and the opaque error messages are not your fault. They are a known friction point that HMRC has acknowledged but, as of 2025, not fully resolved.
Understanding the architecture helps. Your MTD software talks to HMRC through an OAuth 2.0 authorisation flow. In plain English: the software asks HMRC for a token, HMRC asks you to confirm you are who you say you are, and then it hands the token back to the software. That token is what allows every future submission to happen without you having to log in to Government Gateway each time. Get the token right once, and you are done.
What You Need Before You Start
Rushing the linking process without the right credentials to hand is the single biggest cause of failed authorisations. Collect these before you click anything:
Your Government Gateway User ID and password. This is not your email address. It is the 12-digit ID HMRC issued when you first registered. If you have lost it, use the HMRC Personal Tax Account recovery flow before starting. Our post on HMRC Personal Tax Account: Update Your Tax Code Today walks through account access if you are stuck.
Your Unique Taxpayer Reference (UTR). Ten digits, found on any Self Assessment correspondence or inside your personal tax account. The UTR is how HMRC matches your software authorisation to your specific tax record. A single digit wrong and the authorisation will fail silently.
MTD enrolment active on your account. This is the step most people miss. Your Government Gateway account must be enrolled for MTD for Income Tax Self Assessment (ITSA), not just Self Assessment. If you signed up voluntarily through HMRC's MTD pilot, you should be enrolled. If you are not sure, check inside Government Gateway under "Services you can use." If you have not signed up yet, our guide How to Sign Up for MTD Before HMRC Signs You Up covers the enrolment step in full.
Your chosen MTD software open and on the authorisation screen. Different products label this differently: "Connect to HMRC", "Authorise with HMRC", "Link your account", or similar. Find it before you start the clock.
Linking MTD Software to HMRC: Step by Step
Step 1: Initiate the Connection From Your Software
Always start from inside your MTD software, not from Government Gateway. Every compliant product has a button or screen that begins the authorisation process. In TapTax, it is on the dashboard the first time you log in. In larger platforms it is usually buried under Settings > Integrations > HMRC.
When you click the button, the software will open a browser window or redirect tab pointing to HMRC's authorisation server. The URL will contain "oauth.tax.service.gov.uk" or similar. This is legitimate. Do not close it.
Step 2: Log In to Government Gateway
Enter your 12-digit Government Gateway User ID and password. If you use two-factor authentication (which HMRC now requires for most accounts), have your phone ready for the access code.
You will land on a screen that asks which account you want to use if you have both a personal and an agent account. Choose Individual unless you are an accountant authorising on behalf of a client.
Step 3: Confirm the Permission Grant
HMRC will display a screen listing what the software is requesting permission to do: typically read your income and expenses data and submit quarterly updates on your behalf. Read it, then click Grant authority (or equivalent). This is the moment the token is issued.
Do not navigate away, refresh the page, or let your phone lock the screen at this point. HMRC's session is active for roughly 10 minutes. If it expires, you will see an error and need to restart from Step 1. Nothing is broken; you simply need to go again.
Step 4: Return to Your Software
After granting authority, HMRC redirects you back to your MTD software automatically. The software will confirm that it has received and stored the authorisation token. You should see a green confirmation, a "Connected" status badge, or similar.
At this point the link is live. Your software can now pull your MTD enrolment details from HMRC and push quarterly updates when you are ready to submit. You will not need to repeat this process unless you revoke the permission, change Government Gateway accounts, or switch to a different software product.
Step 5: Confirm Your Business Details Match
Before submitting anything, spend two minutes checking that the business name, UTR, and National Insurance number shown inside your MTD software match what HMRC holds. A mismatch here will not prevent authorisation but will cause submissions to be rejected. Check your Self Assessment registration confirmation letter or log in to Government Gateway to verify.
The Four Most Common Failure Points
Wrong Government Gateway account. Many sole traders have accidentally created two or three Government Gateway accounts over the years, different email addresses, different IDs. If the ID you used to authorise does not have MTD enrolment, the link will appear to succeed but submissions will fail. Log in to Government Gateway separately and confirm MTD for ITSA appears under your services.
UTR not recognised. If HMRC returns an error saying your UTR cannot be found, double-check you have entered it without spaces. Some correspondence prints it as XXX-XXXX-XXXX but the system expects ten consecutive digits.
Authorisation granted for the wrong tax. MTD currently covers VAT (already mandatory for most VAT-registered businesses) and Income Tax (from April 2026). If you authorised your software for MTD VAT only, it will not be able to submit MTD ITSA quarterly updates. Check your software settings to confirm which API connection is active.
Software not on HMRC's recognised list. HMRC maintains a list of software that has passed API compatibility testing. Authorising an unrecognised product will either fail outright or result in submissions that HMRC cannot process. Before paying for anything, verify your chosen software appears on HMRC's MTD-compatible software list. Our MTD Software Comparison UK: What the Price Tags Hide breaks down what to look for beyond the HMRC badge.
People also ask
After You Are Linked: What Comes Next
A successful authorisation is the precondition, not the finish line. Once your MTD software is linked to HMRC, you still need to:
Keep digital records throughout the quarter. MTD requires every income and expense entry to originate from a digital source. Pen-and-paper records transcribed into software at the end of the quarter do not comply. HMRC's guidance is clear on this, even if enforcement is not yet rigorous. Our post on MTD Record Keeping Software: What HMRC Won't Build for You explains what counts as a digital record.
Submit quarterly updates on time. Once MTD ITSA is mandatory, you will have four quarterly deadlines plus a final end-of-period statement each tax year. Miss a quarterly deadline and HMRC's late filing penalty points system kicks in: two points for the first miss, and a £200 penalty once you accumulate enough points. For a sole trader with four quarterly obligations per year, that threshold arrives faster than most people expect. See our full walkthrough on How to Submit a Quarterly Update to HMRC: No Jargon.
Use the connection to check your data before submitting. The advantage of a live API link is that some MTD software can pull your current HMRC record and flag discrepancies before you submit. Use that feature. Discovering a mismatch after submission involves amendment requests that HMRC processes slowly.
A Note on Agent Authorisation
If you use an accountant or bookkeeper, they can be authorised to submit on your behalf using HMRC's agent services account. In that case, you authorise your accountant's software rather than your own, and you grant them agent authority via a separate process in Government Gateway. The steps are similar but the screens differ. If your accountant tells you to authorise their software yourself using your own Government Gateway credentials, ask them to clarify who is actually responsible for submissions, as mixed authorisation is a common source of duplicate filings.
Choosing Software That Makes This Easier
Not all MTD software handles the authorisation flow equally well. Some redirect you to HMRC in a pop-up that browsers block by default. Some store your token insecurely and require re-authorisation more often than necessary. Some bury the "connect to HMRC" button so deep in their settings that first-time users give up.
When evaluating options, test the authorisation journey during a free trial before committing. A product that cannot get you connected cleanly is unlikely to improve once you are paying for it. If you want to understand what separates genuinely useful MTD tools from expensive ones, Digital Tax Filing Software UK: What You're Buying vs What You Need is worth ten minutes of your time.
TapTax is designed specifically for sole traders who want the connection established quickly and the quarterly submission process to take minutes rather than an afternoon. The authorisation is a single screen, the redirect stays within the same browser tab, and the UTR validation happens before you ever reach Government Gateway so you are not troubleshooting a failed link you could have prevented.
You might also like
Ready to simplify your tax filing?
Join the waitlist and be the first to know when TapTax launches.