All Docs
FeaturesMaking Tax DigitalUpdated February 21, 2026

Blog: Never Miss a Submission Outcome — Introducing HMRC Notification Alerts

Never Miss a Submission Outcome — Introducing HMRC Notification Alerts

Release: v1.0.28 · Type: Notification Workflow

Submitting your quarterly return to HMRC is a critical moment. Until now, you had to check back manually to confirm whether your submission had been accepted. With v1.0.28, that changes.

Instant Confirmation, Every Time

The moment your quarterly HMRC submission completes, you'll receive a notification — both inside the app and by email. No more guessing. No more manual status checks.

When your submission succeeds

You'll get a clear confirmation that includes everything you need to keep for your records:

  • HMRC Correlation ID — the unique reference HMRC issued for your submission
  • Submission ID — your internal reference
  • Tax year and quarter — exactly what period was covered
  • Net profit and income figures — a summary of what was submitted

This confirmation doubles as a lightweight audit trail you can refer back to at any time.

When something goes wrong

HMRC submissions can be rejected for a number of reasons — an incorrect National Insurance Number, a timing issue with the submission window, or a transient HMRC service error. When this happens, you'll receive an urgent notification that tells you:

  1. What the error code means — in plain English, not HMRC jargon
  2. Exactly what to do next — so you can resolve the issue and resubmit with confidence

For example:

HMRC rejected this submission: invalid NI number — please re-check your National Insurance Number in Settings.

No deciphering cryptic error codes. No searching HMRC documentation. Just a clear explanation and a path forward.

How It's Built

For those interested in the technical detail: notifications are triggered by an event-driven workflow. After the hmrc-quarterly-submit Inngest function completes its final step, it emits an hmrc/quarterly-submit.completed event. A dedicated notification handler picks this up, inspects the submission status (submitted, failed, or rejected), and dispatches the appropriate in-app and email notifications.

Every outcome is also written to the Audit Log, giving you a full, tamper-evident record of every submission attempt and its result.

What This Means for You

Making Tax Digital compliance requires accurate, on-time submissions. Instant notifications mean you can act immediately if something goes wrong — rather than discovering a failed submission days later when it may be too late. Combined with the plain-English guidance, you can fix most issues yourself without needing to contact support.

This is part of our ongoing commitment to making HMRC obligations as stress-free as possible for UK landlords.

See the Changelog for full technical details, or visit the HMRC Submission Notifications feature guide for usage information.