Pull your HealthEquity HSA reports into your own systems

What you can build on the employer portal

• Get HSA contribution history

  Build this

  Reads the Contribution History report from the Reports tab: employer and employee HSA contributions per employee, with pending amounts.

  Takes

  Department (optional)

  Returns

  Employee ID, department, employee name, employer contributions, employee contributions, pending employer and employee contributions

• Get held-up HSA contributions

  Build this

  Reads the Held-up Contributions report: every employer or employee contribution being held, why, and for how many days.

  Takes

  Nothing

  Returns

  Employee ID, employee name, amount contributed, reason for delay, days waiting, employer contributions, employee contributions

• Check HSA status by employee

  Build this

  Reads the HSA Status report: when each employee was enrolled in an HSA, whether the account is activated, and whether it is closed.

  Takes

  Department (optional)

  Returns

  Department, employee name, employee ID, enrollment date, account status

• List possible HSA over-contributions

  Build this

  Reads the Over Contributions report for a tax year: employees whose HSA contributions may be above the IRS limit for their coverage type.

  Takes

  Tax year

  Returns

  Employee name, employee ID

Automate the employer portal with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• New held-up HSA contributions, emailed every Monday

  Build this

  Starts

  Every Monday at 8:00

  Step 1

  Get the Held-up Contributions report from the employer portal.

  Step 2

  Keep the rows that were not there on the last run.

  Step 3

  Email you each one with employee, amount, reason for delay and days waiting.

• Enrolled employees whose HSA is not activated

  Build this

  Starts

  Every Friday at 9:00

  Step 1

  Get the HSA Status report from the employer portal.

  Step 2

  Keep the employees whose account status shows the HSA is not activated.

  Step 3

  Post the list, with enrollment dates, to your HR system's webhook.

• Possible HSA over-contributions, checked monthly

  Build this

  Starts

  On the 1st of every month at 7:00

  Step 1

  Get the Over Contributions report for the current tax year.

  Step 2

  Keep the employees who were not listed on the last run.

  Step 3

  Email you their names and employee IDs.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get HSA contribution history” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "my.healthequity.com/get_hsa_contribution_history",
    "input": {
      "department": "Operations"
    }
  }'

{
  "status": "completed",
  "data": {
    "employer": "Acme",
    "report": "Contribution History",
    "employees": [
      {
        "employee_id": "E10482",
        "department": "Operations",
        "employee_name": "Jordan Ellis",
        "employer_contributions": 750,
        "employee_contributions": 2100,
        "pending_employer_contributions": 0,
        "pending_employee_contributions": 175
      }
    ],
    "currency": "USD"
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

The employer portal’s own options

HealthEquity agrees how each employer shares data during implementation, with a Technical Integration Manager who sets up and tests the integration files. The options it lists are uploads in its Secure Portal, files sent and received by secure FTP, carrier or claims files, and single sign-on and API. The HSA reports are read in the employer portal.

Read on November 12, 2026: HealthEquity: implementation and data integration, HealthEquity Help Center: Health Savings Account Reports.

Signing in to the employer portal

Employer administrators sign in to the employer portal at my.healthequity.com with an admin username and password, and HealthEquity's help center covers updating an admin's username, security questions and password. With Fous you sign in once through the portal's sign-in with your own admin account. The login is sealed with AES-256, never returned by the API or written to logs, and code and AI agents never see it.

Worth knowing

Reports need the View Reports permission

The HSA reports open only for admins with the View Reports permission. A method reads only what its account can, so sign in with an admin who has it.

Why contributions are held

The Held-up Contributions report gives a reason for each held amount, such as the customer identification process required by the US PATRIOT Act, FSA coverage or contribution limits.

Over Contributions is an estimate

It takes coverage type from the eligibility currently being sent and counts contributions made directly by members, so it may not match Contribution History.

Two employer sites

HealthEquity's employer FAQ links to two employer sign-ins: my.healthequity.com and a separate Employer login at employer.wageworks.com. Build each method on the site where your reports are.

More in Insurance

• Allianz Maklerportal
• Aviva Broker
• AXA Connect
• PPL
• Navigate
• HealthSherpa
• Covered California Enroller Portal
• HealthCare.gov for agents and brokers
• Optum Financial employer portal
• WEX Benefits employer portal
• NIPR
• Aflac Business Services
• National General agent portal
• Travelers for Agents
• Nationwide Agent Center
• The Hartford EBC
• Citizens PolicyCenter and myAgency

Other industries: CounselLink, douane.gouv.fr, NetX360+, Maersk.com, C3 Reservations, eSupplierConnect.