---
title: Why a Healthlink message sent is now in the Failed folder?
description: When an attempt is made to send a Healthlink message, the message does not reach the recipient and the message is saved in the Failed folder. The most likely caused is that the created message has fai
---

[Skip to content](https://knowledge.gensolve.com/migration/knowledge/why-a-healthlink-message-sent-is-now-in-the-failed-folder#main-content)

English

Show submenu for translations

[Customer portal](https://knowledge.gensolve.com/help?hsLang=en)

![gensolve-logo-white-kb.png\]](https://knowledge.gensolve.com/hs-fs/hubfs/gensolve-logo-white-kb.png?height=40&name=gensolve-logo-white-kb.png)

- [Default HubSpot Blog](https://knowledge.gensolve.com/blog)

Open main navigation

Close main navigation

- [Default HubSpot Blog](https://knowledge.gensolve.com/blog)
- English
  
  Show submenu for translations
- [Customer portal](https://knowledge.gensolve.com/help)
- Go to gensolve.com

 Go to gensolve.com

 Welcome to Gensolve

- There are no suggestions because the search field is empty.

1. [Knowledge Centre](https://knowledge.gensolve.com/migration/knowledge?hsLang=en)
2. [Gensolve Enterprise Manager](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en)
3. [Healthlink](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#healthlink)

# Why a Healthlink message sent is now in the Failed folder?

### Issue

When an attempt is made to send a Healthlink message, the message does not reach the recipient and the message is saved in the Failed folder.

### Reason

The most likely caused is that the created message has failed due to the recipient EDI being incorrect.

### Solution

#### Validate why the message failed to be processed

1. Go to the **Healthlink tab**\>\> **Messages** tab \>\> Click on the **Failed** folder \>\> Click on **Get Data** \>\> Click on the ![](https://docs.testpublic.gensolve.com/docs/gpm_nz/desktop/Icons/edit.jpg) button next to the failed message.

![](https://docs.testpublic.gensolve.com/docs/gpm_nz/desktop/Knowledge_Base/Healthlink/Graphics/HealthlinkFailed_Edit_NZ.png)

2. In the message's details window, click on the **View Status** button to see why the message failed to be sent. Click on **OK** to close the window.

![](https://docs.testpublic.gensolve.com/docs/gpm_nz/desktop/Knowledge_Base/Healthlink/Graphics/HealthlnkFailed_ViewStatus_NZ.png)

The Error Message below indicates that the message failed to be delivered due to an invalid EDI.

#### Replace the invalid EDI

Now that it has been identified why the message failed to be sent, it is necessary to remove the incorrect EDI from that Referrer and replace it with the correct EDI by the following steps:

1\. Find the correct EDI for the Referrer by either contacting the Referrer directly, or by downloading the [Healthlink EDI Guide](https://nz.healthlink.net/knowledge-base/edi-guides/how-do-i-find-the-edi-address-for-a-healthlink-customer/).

2. Click on the ![](https://docs.testpublic.gensolve.com/docs/gpm_nz/desktop/Icons/edit.jpg) button next to the Referrer.

![](https://docs.testpublic.gensolve.com/docs/gpm_nz/desktop/Knowledge_Base/Healthlink/Graphics/HealthlinkFailed_EditReferrer_NZ.png)

3. Go to the **Referrer Details** tab \>\> Enter the correct EDI for the Referrer. \>\> Click on **Save**.

![](https://docs.testpublic.gensolve.com/docs/gpm_nz/desktop/Knowledge_Base/Healthlink/Graphics/HealthlinkFailed_ReferrerEDI_NZ.png)

4\. Now that the Referrer's EDI has been correctly configured, the message must be recreated and sent again. This time, the message should appeared in the Successful folder.

![](https://docs.testpublic.gensolve.com/docs/gpm_nz/desktop/Knowledge_Base/Healthlink/Graphics/HealthlinkFailed_SuccessfulSent_NZ.png)

 

- [Gensolve Enterprise Manager](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#main-content)

    - [Accounting](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#accounting)
    - [Administration](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#administration)
    - [Videos](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#videos)
    - [Appointments](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#appointments)
    - [Billing & payments](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#billing-payments)
    - [Clients](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#clients)
    - [Clinicians](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#clinicians)
    - [Conditions & medical notes](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#conditions-medical-notes)
    - [Front office](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#front-office)
    - [Gensolve API](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#gensolve-api)
    - [Healthlink](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#healthlink)
    - [Internet connection](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#internet-connection)
    - [Letters & Templates](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#letters-templates)
    - [Reports](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#reports)
    - [Troubleshooting](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#troubleshooting)
    - [Working with files](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#working-with-files)
    - [Web portal](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#web-portal)
    - [Custom forms](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#custom-forms)
    - [Installation & troubleshooting](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#installation-troubleshooting)
    - [Medicare](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#medicare)
    - [Online payment](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#online-payment)
    - [Telehealth](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#telehealth)
    - [Tyro](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#tyro)
    - [Managing Conditions](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#managing-conditions)
    - [Using the Support Centre & Accessing Information](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#using-the-support-centre-accessing-information)
    - [Main Form](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#main-form)
    - [processes](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#processes)
    - [Hints & Tips](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#hints-tips)
    - [ACC](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#acc)
    - [Contract](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#contract)
    - [Built-In Reports](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#built-in-reports)
    - [GPM\_Light](https://knowledge.gensolve.com/migration/knowledge/gensolve-enterprise-manager?hsLang=en#gpm_light)
- [GPM Web](https://knowledge.gensolve.com/migration/knowledge/gpm-web?hsLang=en#main-content)

    - [Appointment Book in GPM Web](https://knowledge.gensolve.com/migration/knowledge/gpm-web?hsLang=en#appointment-book-in-gpm-web)
    - [Troubleshooting in GPM Web](https://knowledge.gensolve.com/migration/knowledge/gpm-web?hsLang=en#troubleshooting-in-gpm-web)
- [Release Notes](https://knowledge.gensolve.com/migration/knowledge/release-notes?hsLang=en#main-content)

    - [New Zealand Release Notes](https://knowledge.gensolve.com/migration/knowledge/release-notes?hsLang=en#new-zealand-release-notes)
    - [Audio New Zealand](https://knowledge.gensolve.com/migration/knowledge/release-notes?hsLang=en#audio-new-zealand)
    - [AU Release Notes](https://knowledge.gensolve.com/migration/knowledge/release-notes?hsLang=en#au-release-notes)
    - [UK Release Notes](https://knowledge.gensolve.com/migration/knowledge/release-notes?hsLang=en#uk-release-notes)
    - [Erent](https://knowledge.gensolve.com/migration/knowledge/release-notes?hsLang=en#erent)
- [Gensolve Audio Enterprise Manager](https://knowledge.gensolve.com/migration/knowledge/gensolve-audio-enterprise-manager?hsLang=en#main-content)

    - [ACC](https://knowledge.gensolve.com/migration/knowledge/gensolve-audio-enterprise-manager?hsLang=en#acc)
    - [Accounting](https://knowledge.gensolve.com/migration/knowledge/gensolve-audio-enterprise-manager?hsLang=en#accounting)
    - [Administration](https://knowledge.gensolve.com/migration/knowledge/gensolve-audio-enterprise-manager?hsLang=en#administration)
    - [Appointments](https://knowledge.gensolve.com/migration/knowledge/gensolve-audio-enterprise-manager?hsLang=en#appointments)
    - [How To Create A Bank Reconciliation Using QIF File](https://knowledge.gensolve.com/migration/knowledge/gensolve-audio-enterprise-manager?hsLang=en#how-to-create-a-bank-reconciliation-using-qif-file)
    - [ACC Insurer Schedules](https://knowledge.gensolve.com/migration/knowledge/gensolve-audio-enterprise-manager?hsLang=en#acc-insurer-schedules)
    - [ACC Payments Rejections](https://knowledge.gensolve.com/migration/knowledge/gensolve-audio-enterprise-manager?hsLang=en#acc-payments-rejections)
    - [Loans Introduced](https://knowledge.gensolve.com/migration/knowledge/gensolve-audio-enterprise-manager?hsLang=en#loans-introduced)
    - [Working with Account Entries and Ledgers](https://knowledge.gensolve.com/migration/knowledge/gensolve-audio-enterprise-manager?hsLang=en#working-with-account-entries-and-ledgers)

- [Default HubSpot Blog](https://knowledge.gensolve.com/blog)

[![Chill listening crop-3](https://knowledge.gensolve.com/hs-fs/hubfs/go1-icon-2.png?width=55&height=55&name=go1-icon-2.png "Chill listening crop-3")](http://gensolve.com)

Gensolve Knowledge Centre

<https://www.facebook.com/gensolve/?ref=hl> <https://twitter.com/Gensolve_> <https://www.linkedin.com/company/1176066>

Copyright © 2026, Gensolve Pty Ltd