My workflow isn't working and I can't tell why

There is nothing more frustrating than setting up a workflow and having no idea if it is actually doing anything. Here is how to figure out what is going wrong.

Step 1: Check the Logs tab

Every workflow has a Logs tab. Open your workflow and click on it.

Green entries = successful runs
Red entries = failed runs

Click into any entry to see which nodes ran and which ones failed. Click a failed node to see the specific error message.

Step 2: Ask Jarvis

Jarvis can iterate on your workflows and searches. Copy and paste the error or explain the situation in detail so you it knows as much as possible.

This is a suggested step before contacting support

Common issues

Problem	What to check
Workflow not running at all	Is it published? Workflows in draft mode do not run.
Node shows "variable not found"	You are referencing a variable from a node that is not connected or has not run yet.
`If Condition` blocks everything	Double-check your condition logic. Try changing "equals" to "contains" or vice versa and the output of the last node.
Enrichment fails	Check your credit balance in Settings. Empty balance = all enrichment fails silently.
No posts coming through	Check your Listening search. Is it finding posts? Are the keywords too narrow?

Debugging tips

Test with a single post first. Before scaling up, run your workflow manually on one post to make sure every node works correctly. Check the output of each node in the logs.

Build incrementally. Start with just a trigger and one node. Confirm it works, then add the next node. This makes it easy to pinpoint where things break.