All articles

Workflows

Debug a failed workflow run

Use the runs viewer to see which step failed, what the error was, and the trigger payload that caused it.

Open the runs viewer

Workflows table → row dropdown → View runs. Each run is one execution.

Read the step log

Expand any run to see per-step status:

  • Green check = step succeeded
  • Red X = step failed (workflow halts on hard errors except branch_if)
  • branch: true / false badge = which branch a branch_if took

Common errors

  • "RESEND_API_KEY not configured" — set the env var or remove the email step
  • "No customer in context" — your tag_customer step ran on a workflow without a customer (e.g., manual trigger). Add a contact_created trigger or filter.
  • "AI generation failed" — your LLM provider returned an error. Check /dashboard/health.

Re-run with the same payload

Open the workflow in the builder, click Test run, paste the trigger payload from the failed run, and trace through it.

Was this helpful? Email support@nexxss.com and we'll improve the article.