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

# Troubleshooting workflows

> Refer to this page if you've run into issues creating or starting a workflow.

<AccordionGroup>
  <Accordion title="Workflow stops and shows the 401 error">
    Check custom integration steps and verify that the phrase Api-Key is present in the Header.

    1. In the left-hand navigation, click **Workflows**.
    2. Click the workflow containing the integration step.
    3. Click **Settings** to edit the step.
    4. Make sure your API key is proceeded by the **Api-Key** phrase.

    Alternatively, a 401 error might mean that the account connected to an integration step got deactivated or deleted. It might also show if the same account was connected in another environment and then disconnected.
  </Accordion>

  <Accordion title="I'm getting an Unauthorized error when I try to push data to Google Sheets">
    This might happen when you don't select Google Slides in the **Authorization** field in the integration step's settings.
  </Accordion>

  <Accordion title="Why does my integration step show as skipped?">
    This happens if you have selected to skip a failed step. You can configure this in the step's settings in the **On Failure** section. Probably the step failed and it was skipped.

    <Frame>
      <img src="https://mintcdn.com/nextmatter/SgcAiYe3VpK6bFPP/images/docs/cc396cf-error.png?fit=max&auto=format&n=SgcAiYe3VpK6bFPP&q=85&s=007e8d22f107dff03a51eac845172003" alt="Image of a failed and skipped integration step" width="1452" height="696" data-path="images/docs/cc396cf-error.png" />
    </Frame>

    To quickly see what the issue with the step might be, expand the skipped step and right-click to inspect. Next, delete the overlay `<div>`.

    <Frame>
      <img src="https://mintcdn.com/nextmatter/I7XEPsBmVpUZVtva/images/docs/2ce5e2e-Screenshot_2023-03-21_at_21.35.55.png?fit=max&auto=format&n=I7XEPsBmVpUZVtva&q=85&s=699cb24b7f6da180e9ed1855e033f927" alt="A screenshot of the CSS code with the overlay settings highlighted" width="1064" height="414" data-path="images/docs/2ce5e2e-Screenshot_2023-03-21_at_21.35.55.png" />
    </Frame>
  </Accordion>

  <Accordion title="The data reference gets pushed to an external system as raw variables, not the actual data">
    This might happen when you edit the **Body** in an external JSON editor and then copy it over to Next Matter. Data references need to be selected directly in Next Matter (by clicking the braces and selecting the value from the dropdown).
  </Accordion>

  <Accordion title="Why is the variable I created breaking my integration">
    It might be because there are brackets or braces to the variable name. Make sure the name doesn't contain any brackets or braces.
  </Accordion>

  <Accordion title="I'm getting a Step not found error">
    If you're getting this error when clicking **Test integration** in the **Complete step automatically** template, it's because the auto-complete step relies on the instance ID of the running instance. Clicking **Test integration** in the editor with no running instance will always produce this error even if all placeholders are correct.
  </Accordion>

  <Accordion title="My instance gets stuck on an integration step">
    If this happens, try refreshing the screen.
  </Accordion>

  <Accordion title="How do I retry and update a failed step?">
    Your integration test might fail with a Bad gateway or Not authorized error. In such cases, you can take over a step, re-configure it, and retry.

    <Info>
      You can take over a step if you're a workflow owner or a workflow tech lead.
    </Info>

    <iframe width="560" height="315" src="https://demo.arcade.software/vTN4rrgMQjpAI5PWyzFS?embed&show_copy_link=true" title="Tutorial" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />
  </Accordion>

  <Accordion title="The condition I created for a form field doesn't work">
    It might be because you've edited the value that's used in the condition, and you haven't updated the condition itself.
  </Accordion>
</AccordionGroup>
