Troubleshooting
Use this page when a workflow, trigger, report, connection, or data screen does not behave as expected.
Workflow Has Problems
Symptoms:
- The Problems panel shows validation errors.
- The workflow cannot run.
- A trigger starts the workflow, but execution fails immediately.
Checks:
- Open the workflow editor.
- Review the Problems tab.
- Open each step mentioned by validation.
- Confirm required input mappings, connections, and child workflows.
- Save and run the workflow manually before relying on a trigger.
Trigger Does Not Start a Workflow
Symptoms:
- No execution appears in Invocation History.
- An external caller receives an error.
- A scheduled run does not appear at the expected time.
Checks:
- Confirm the trigger is Active.
- Confirm it points to the intended workflow.
- Confirm the workflow validates.
- For HTTP triggers, confirm the endpoint and request payload.
- For scheduled triggers, confirm the schedule and timezone expectation.
- For channel triggers, confirm the connection is configured.
Report Does Not Render
Symptoms:
- Report page is empty or shows an error.
- A chart has no data.
- A report editor block references a missing field.
Checks:
- Confirm the report source schema exists in Database.
- Confirm each block field exists on that object type.
- Confirm the object type has records.
- Refresh the report viewer.
- If Explore is empty, check whether the report exposes semantic datasets.
Report Results Look Wrong
Symptoms:
- A chart, metric, or table shows unexpected values.
- A report appears to use the wrong grouping or aggregate.
- A report updates but still does not match the intended source data.
Checks:
- Open the report editor.
- Confirm the report uses the intended source schema.
- Check each affected block’s filters, grouping field, aggregate, value field, sort order, and limit.
- Confirm the source object type has current records for the fields used by the block.
- Refresh the report viewer after changing report configuration or source records.
Connection Fails
Symptoms:
- Provider calls fail inside workflow executions.
- Request volume appears high on a connection card.
- Rate-limit analytics show throttling.
Checks:
- Open Connections and verify the connection exists.
- Confirm the workflow step or trigger uses the intended connection.
- Confirm the provider configuration is current.
- Review Analytics > Rate Limits.
- Retry with a small manual workflow run.
File Is Missing
Symptoms:
- A workflow output file does not appear.
- Import or export fails.
- A file reference cannot be opened.
Checks:
- Confirm default file storage is configured.
- Open the workflow run in Invocation History and inspect the step that should create the file.
- Check Files for the expected output.
- Confirm the workflow passed a file reference instead of raw content when required.