> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Told When a Workflow Fails, and Fix It

> Get an email when a workflow run fails, see which step failed and why, fix it, test it, and switch a paused workflow back on

A workflow that runs on its own can fail with nobody watching: a website it calls changes its address, a key expires. Hiveku can email you when that happens, shows what went wrong, and pauses a workflow that keeps failing until you fix it.

This guide follows a Northwind workflow that pulls green coffee prices from an importer every 15 minutes. Its web address was wrong, so every run failed.

## Get an email when a run fails

In the workflow, click the gear at the top right and switch on **Email admins when a triggered run fails**. Account owners and admins then get an email when a run the workflow started on its own fails. You get one email per problem, not one per failed run, and a **Test Run** never sends one.

![The gear button, outlined, and its menu with Email admins when a triggered run fails, One email per incident. Test runs never alert, switched on and outlined](https://mintcdn.com/locusdigital/W4QIbRZCa_PI4nD5/images/how-tos/workflows/ff-01-alerts-closeup.webp?fit=max\&auto=format\&n=W4QIbRZCa_PI4nD5\&q=85\&s=40a540ccf4f17a0dc569ff17b89a35a9)

Failure emails, switched on

## See that it failed

On the **Workflows** page, click **Manage** next to **All Workflows**. A failed run shows in **Needs your attention** at the top: click it to read the error. The workflow's row says how many runs have failed in a row.

![Needs your attention: Workflow Pull green coffee prices failed, opened, with the error from the API Call step, outlined, and Dismiss](https://mintcdn.com/locusdigital/W4QIbRZCa_PI4nD5/images/how-tos/workflows/ff-02-attention-closeup.webp?fit=max\&auto=format\&n=W4QIbRZCa_PI4nD5\&q=85\&s=fa8c9e0863ef610ac052e5c45340fbcd)

A failed run, in Needs your attention

## Find the step that failed

**1. Open the failed run**

Open the workflow and click **Runs**. Failed runs are red and say which step failed. Click one.

**2. Click the red step**

Its panel shows the **Error**. Here the API Call step could not reach its address, because the address was wrong.

![The API Call step marked Failed with its Error box, outlined, and two failed Scheduled runs in Run History, outlined](https://mintcdn.com/locusdigital/W4QIbRZCa_PI4nD5/images/how-tos/workflows/ff-03-what-failed-closeup.webp?fit=max\&auto=format\&n=W4QIbRZCa_PI4nD5\&q=85\&s=80e01c2b85fb9b73fc71e3d78ed15f48)

The failed step and its error

## When it keeps failing, it pauses

When 5 runs in a row fail, and the workflow started them itself, for example on a schedule, Hiveku pauses it so it stops failing. Owners and admins get an email that it was paused, and **Needs your attention** says so too.

![Needs your attention: Workflow Pull green coffee prices was paused, opened: it is no longer running, it was auto-paused after repeated failures, fix the failing step, then re-enable it in the workflow editor. Details: 5 consecutive failed runs. Outlined](https://mintcdn.com/locusdigital/W4QIbRZCa_PI4nD5/images/how-tos/workflows/ff-04-paused-notice-closeup.webp?fit=max\&auto=format\&n=W4QIbRZCa_PI4nD5\&q=85\&s=3825cce4dece99cfdc57655c0d5c621f)

The pause, in Needs your attention

In the list, the workflow reads **Paused**, and **Paused** above the list shows only the paused ones.

![The Paused filter with 1, outlined; the Pull green coffee prices row with the status Paused, outlined, and Last run Failed, 5 failures in a row, outlined](https://mintcdn.com/locusdigital/W4QIbRZCa_PI4nD5/images/how-tos/workflows/ff-05-paused-row-closeup.webp?fit=max\&auto=format\&n=W4QIbRZCa_PI4nD5\&q=85\&s=f2d3c485e46c825d1b36fba430a7f25d)

Paused, after 5 failures in a row

A workflow that a webhook or a new website visitor starts never pauses, so you never miss a lead. With failure emails on, you still hear about each problem.

## Fix it, test it, and switch it back on

**1. Open the workflow**

A red bar across the top says the workflow is paused and its triggers are ignored.

![Workflow paused, triggers are ignored: This workflow was auto-paused after 5 consecutive failed runs. Investigate the failures before resuming. The Resume workflow button outlined](https://mintcdn.com/locusdigital/W4QIbRZCa_PI4nD5/images/how-tos/workflows/ff-06-paused-banner-closeup.webp?fit=max\&auto=format\&n=W4QIbRZCa_PI4nD5\&q=85\&s=ca80ee1be3e55be54e4e4651445b00ca)

Paused, with Resume workflow

**2. Fix the step**

Click the step that failed and correct what the error named. Here the address was wrong, so the **URL** gets one that works. Click **Save Workflow**.

![The API Call step's settings with the corrected URL, outlined](https://mintcdn.com/locusdigital/W4QIbRZCa_PI4nD5/images/how-tos/workflows/ff-08-fixed-address-closeup.webp?fit=max\&auto=format\&n=W4QIbRZCa_PI4nD5\&q=85\&s=56c67d6ec0d5a896d2de805029f28ddd)

The corrected address

**3. Test it**

Click **Test Run**. When every step is done, the banner reads **Test completed**.

![Test completed, 2/2 steps, outlined, and the API Call step marked Done, outlined](https://mintcdn.com/locusdigital/W4QIbRZCa_PI4nD5/images/how-tos/workflows/ff-09-test-passes-closeup.webp?fit=max\&auto=format\&n=W4QIbRZCa_PI4nD5\&q=85\&s=22ea00ace6ecdf5753d5767f68438516)

The fixed workflow, tested

**4. Resume it**

Click **Resume workflow** in the red bar. The bar goes, and the workflow runs again from its next scheduled time.

**5. Check the next run**

After the next scheduled time, open the workflow's runs (on the **Manage** page, the workflow's menu, then **View executions**). Its first run after the fix is **Completed**.

![The workflow's runs: a Scheduled run, Completed, 2/2 steps, outlined, above the Test run and two earlier Scheduled runs that Failed at API Call](https://mintcdn.com/locusdigital/W4QIbRZCa_PI4nD5/images/how-tos/workflows/ff-10-runs-again-closeup.webp?fit=max\&auto=format\&n=W4QIbRZCa_PI4nD5\&q=85\&s=60198a8a76076fb78bda2dce43529e4f)

Completed again, after the failures

## Good to know

* **Not every failure needs you.** A run can fail once because a website was briefly down. The notice says the workflow will run again on its next trigger; if the next runs work, there is nothing to fix.
* **Dismiss** clears a notice from **Needs your attention** once you have dealt with it. A new problem raises a new one.
* **Test runs never pause a workflow or send a failure email,** so you can test as often as you like while you fix it.
* **More:** [See What a Workflow Did](/how-tos/workflows/see-what-a-workflow-did.md) and [Workflows](/integrations/workflows.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.