Troubleshooting workflows
Refer to this page if you’ve run into issues creating or starting a workflow.
How to debug failed integration steps from email data
How to debug failed integration steps from email data
The email notification provides an admin or a tech lead with all the debugging data without the need to log in to the Next Matter app to investigate.
The email is enriched with the X-Custom-Data header that you can decode:
- Open the email to view its source. For example:
- In Gmail, click the three dots (⋮) in the top right and select Show original.
- In Outlook Web, click the three dots (⋮) and select View source.
-
Search for X-Custom-Data.
-
Copy the data into a base64 decoder. You can use this decoder (external link).
The decoded data might look like the following:
The status and body information is displayed for custom integration steps, and debug_errors for most of our no-code steps.
Workflow stops and shows the 401 error
Workflow stops and shows the 401 error
Check custom integration steps and verify that the phrase Api-Key is present in the Header.
- In the left-hand navigation, click Workflows.
- Click the workflow containing the integration step.
- Click Settings to edit the step.
- Make sure your API key is preceded 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.
I'm getting an Unauthorized error when I try to push data to Google Sheets
I'm getting an Unauthorized error when I try to push data to Google Sheets
Why does my integration step show as skipped?
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.
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>.
The data reference gets pushed to an external system as raw variables, not the actual data
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).
Why is the variable I created breaking my integration?
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.
I'm getting a Step not found error
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.
My instance gets stuck on an integration step
My instance gets stuck on an integration step
If this happens, try refreshing the screen.
How do I retry and update a failed step?
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, reconfigure it, and retry.
You can take over a step if you’re a workflow owner or a workflow tech lead.
The condition I created for a form field doesn't work
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.
Troubleshooting workflows
Refer to this page if you’ve run into issues creating or starting a workflow.
How to debug failed integration steps from email data
How to debug failed integration steps from email data
The email notification provides an admin or a tech lead with all the debugging data without the need to log in to the Next Matter app to investigate.
The email is enriched with the X-Custom-Data header that you can decode:
- Open the email to view its source. For example:
- In Gmail, click the three dots (⋮) in the top right and select Show original.
- In Outlook Web, click the three dots (⋮) and select View source.
-
Search for X-Custom-Data.
-
Copy the data into a base64 decoder. You can use this decoder (external link).
The decoded data might look like the following:
The status and body information is displayed for custom integration steps, and debug_errors for most of our no-code steps.
Workflow stops and shows the 401 error
Workflow stops and shows the 401 error
Check custom integration steps and verify that the phrase Api-Key is present in the Header.
- In the left-hand navigation, click Workflows.
- Click the workflow containing the integration step.
- Click Settings to edit the step.
- Make sure your API key is preceded 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.
I'm getting an Unauthorized error when I try to push data to Google Sheets
I'm getting an Unauthorized error when I try to push data to Google Sheets
Why does my integration step show as skipped?
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.
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>.
The data reference gets pushed to an external system as raw variables, not the actual data
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).
Why is the variable I created breaking my integration?
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.
I'm getting a Step not found error
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.
My instance gets stuck on an integration step
My instance gets stuck on an integration step
If this happens, try refreshing the screen.
How do I retry and update a failed step?
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, reconfigure it, and retry.
You can take over a step if you’re a workflow owner or a workflow tech lead.
The condition I created for a form field doesn't work
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.