MTD Software Not Connecting to HMRC: Fix It Fast
Your MTD software won't connect to HMRC and a deadline is looming. Here is exactly why it breaks and how to fix it before penalties hit.
Your MTD software says it cannot connect to HMRC, the quarterly deadline is in three days, and your laptop is one bad update away from being thrown through the window. You are not alone, and you have not done anything wrong.
- MTD software connection failures are almost always caused by one of five fixable issues: expired authorisation, browser cookies, HMRC service outages, incorrect Government Gateway credentials, or software that is not on HMRC's approved list.
- HMRC's own MTD API experiences scheduled and unscheduled downtime. Checking the HMRC service status page takes 30 seconds and eliminates the most common culprit immediately.
- Re-authorising your MTD software with HMRC typically resolves persistent connection failures. Authorisation tokens expire, often without any warning from the software itself.
- Missing a quarterly update deadline due to a software connection failure does not automatically excuse you from penalties. HMRC expects you to have a reasonable excuse documented and ready.
- Switching to simpler MTD software with a cleaner HMRC integration reduces the chance of connection failures significantly.
Connection failures between MTD software and HMRC are one of the most reported frustrations among sole traders preparing for Making Tax Digital compliance. They happen at the worst possible moment, they come with error messages that read like they were written for a network engineer, and the clock keeps ticking regardless.
This post will walk you through every realistic cause, in order of likelihood, and give you the specific steps to fix each one. No jargon, no vague suggestions to "check your settings."
- MTD Software Authorisation
- The process by which your MTD-compatible software is granted permission to communicate with HMRC's systems on your behalf via the Government Gateway. This authorisation is time-limited and must be renewed periodically, usually every 18 months, though individual software products vary.
Why Your MTD Software Cannot Connect to HMRC
Before you reinstall anything or call a helpline, understand the architecture. Your MTD software does not send data directly to an HMRC inbox. It communicates via HMRC's Application Programming Interface (API), a digital gateway that handles millions of requests from hundreds of software products. If anything in that chain breaks, including your software, your internet connection, your browser session, or HMRC's own servers, the connection fails.
The good news: most failures are on the near end of that chain, which means they are fixable in under ten minutes.
Cause 1: Expired or Revoked Authorisation Token
This is the most common cause of MTD software not connecting to HMRC, and it is the one most software vendors fail to warn you about clearly.
When you first set up your MTD software, you were asked to log in to the Government Gateway and grant the software permission to act on your behalf. That permission does not last forever. HMRC issues time-limited authorisation tokens. Depending on your software, these expire after 18 months or when you change your Government Gateway password.
The fix: Go into your software's settings, find the HMRC connection or integration section, and look for a "Re-authorise" or "Reconnect to HMRC" button. Click it, log in to the Government Gateway when prompted, and grant permission again. This typically resolves the issue immediately.
If you recently changed your Government Gateway password for any reason, including a routine security prompt, this step is almost certainly what you need.
Cause 2: HMRC's API Is Down
HMRC's digital infrastructure is not infallible. The MTD API experiences both scheduled maintenance windows and unscheduled outages. During these periods, no software product on earth can connect to HMRC, because the problem is at HMRC's end, not yours.
The fix: Before anything else, visit the HMRC service availability and issues page. HMRC publishes real-time status updates for all its digital services, including the Income Tax (MTD) API. If there is a known issue, it will be listed there. Your only option is to wait and try again once the service is restored. Document the outage date and time; you may need this if a deadline is missed.
Cause 3: Incorrect Government Gateway Credentials
This sounds obvious, but it catches more people than it should. The Government Gateway account linked to your MTD software must be your business Government Gateway account, the one enrolled for Self Assessment and MTD, not a personal account, a spouse's account, or an old account from a previous tax year when you briefly tried a different service.
Some sole traders have multiple Government Gateway user IDs and do not remember which one is tied to MTD. Others have had their accounts merged or migrated by HMRC and the credentials they saved in their browser are now stale.
The fix: Log in to your Government Gateway account directly at gov.uk and confirm you can see your MTD enrolment under "Your tax account." If you cannot, you may need to re-enrol for MTD. Then return to your software and re-authorise using those exact credentials.
Cause 4: Your Software Is Not on HMRC's Approved List
Not all software marketed as "MTD compatible" is formally approved by HMRC. The distinction matters. HMRC maintains a published list of software products that have been tested and recognised for MTD for Income Tax Self Assessment (ITSA). If your software is not on that list, or if it was removed following a failed re-assessment, connections will fail regardless of what you do on your end.
This is particularly relevant for sole traders who opted for a cheaper or obscure product, or who are using accounting software that added an "MTD module" without going through HMRC's full recognition process.
The fix: Search "HMRC MTD for Income Tax compatible software" and check the official GOV.UK guidance page. Find your product in the list. If it is absent, you need to switch software before your next submission deadline. See our guide on How to Switch to MTD Software Without Losing a Day's Work for a process that keeps disruption to a minimum.
Cause 5: Browser, Cookie, or Firewall Interference
Some MTD software uses a browser-based OAuth flow to handle the Government Gateway login during authorisation. If your browser is blocking third-party cookies, running an aggressive ad-blocker, or sitting behind a corporate firewall, the authorisation handshake can fail silently, leaving you staring at a "connection failed" message with no further explanation.
The fix:
- Try the authorisation process in a different browser, ideally Chrome or Edge, with no extensions active
- Temporarily disable any VPN you are running
- If you are on a work network or using a router with content filtering, try on your mobile data connection to isolate whether the network is the problem
- Clear your browser cookies and cache, then attempt re-authorisation from scratch
Cause 6: Software Needs an Update
MTD software vendors must update their products whenever HMRC updates the API. If you are running an outdated version of your software, it may be attempting to communicate with an API endpoint that no longer exists or has changed its authentication requirements.
The fix: Check for software updates. In most desktop applications this is under Help > Check for Updates. For web-based tools, updates are applied automatically, but check the vendor's release notes or status page to confirm there are no known issues with the current version.
What to Do If Nothing Works
If you have worked through all six causes above and the MTD software is still not connecting to HMRC, the next steps are:
Contact Your Software Vendor First
Not HMRC. The software vendor is responsible for the integration between their product and HMRC's API. They will have access to error logs and can tell you whether the issue is specific to your account or affecting multiple users. If it is affecting multiple users, that is their problem to fix, not yours.
Document everything: screenshots of error messages, the date and time you attempted connection, which steps you tried. This matters if a penalty dispute arises later.
Contact HMRC as a Last Resort
HMRC's MTD helpline exists but is not the fastest route to a solution for technical connection issues. Their agents can confirm whether your enrolment is active and whether there are any flags on your account, but they cannot fix your software. The number is 0300 200 3310, and the lines are busiest on Monday mornings.
Document Everything for a Reasonable Excuse Claim
If a quarterly submission deadline passes because your MTD software could not connect to HMRC, you may be able to avoid a penalty by submitting a reasonable excuse claim. HMRC's guidance states that technical failures beyond your control can constitute a reasonable excuse, but the burden of proof is on you.
Keep records of:
- Screenshots of the error message with timestamp
- Any HMRC service outage notifications
- Your correspondence with the software vendor
- Evidence that you attempted to submit before the deadline
The penalty for a missed quarterly update under MTD is point-based. You accumulate one point per missed deadline, and once you reach the threshold (two points for quarterly filers), a £200 penalty applies. Each additional missed deadline after that triggers another £200. That is not abstract: for a sole trader missing two consecutive quarters, that is £200 out of pocket before you have paid a penny of tax. More detail on what those error messages actually mean is in our post on HMRC MTD Error Codes: What They Mean and How to Fix Them.
The Deeper Problem: Why This Keeps Happening
It is worth naming who bears the cost here. HMRC mandated that sole traders use third-party software for MTD rather than building a fully functional free tool itself. The free HMRC product covers only the most basic cases. That policy decision means the reliability of your tax compliance now depends on a software vendor's engineering team keeping pace with HMRC's API changes.
When HMRC updates its API, vendors have a window to update their products. If a vendor is slow, or if you have not updated your software, the connection breaks. You are the one facing penalties, not the vendor, and not HMRC.
For a fuller look at the problems baked into MTD's design, our post on Making Tax Digital Problems Nobody Warned You About covers the structural issues that sole traders are only discovering now.
How to Reduce the Risk of Future Connection Failures
Once you have fixed the immediate problem, here is how to make it less likely to recur:
- Set a calendar reminder to re-authorise your software every 12 months, even if the token has not expired. Treat it like renewing your van's MOT.
- Keep your Government Gateway credentials in a password manager, so you are never hunting for them at deadline time.
- Check HMRC's service status page the day before any submission deadline, so you know in advance if there is a planned maintenance window.
- Subscribe to your software vendor's status updates or release notes, so you hear about API-related updates before they cause a connection failure.
- Use software with a clean, purpose-built HMRC integration rather than a large accounting suite with an MTD bolt-on. Simpler integrations have fewer points of failure.
If you are still using software that regularly causes connection headaches, it may be worth reconsidering your choice entirely. The MTD Common Mistakes Sole Traders Make Before Filing post covers the software selection errors that compound into bigger problems at submission time.
People also ask
The Takeaway
If your MTD software is not connecting to HMRC right now, start with the simplest check: is HMRC's API actually up? Thirty seconds on their service status page could save you an hour of fruitless troubleshooting. If the service is running, work through expired authorisation, wrong credentials, and browser interference in that order. Nine times out of ten, one of those three fixes it.
And if you find yourself fixing this same problem every few months, that is a signal worth paying attention to. The software you choose for MTD compliance is not a minor admin detail; it is the single piece of infrastructure standing between you and an HMRC penalty. It should work reliably, every time, without requiring you to become a network engineer.
You might also like
Ready to simplify your tax filing?
Join the waitlist and be the first to know when TapTax launches.