Workflow Error Notifications and Needs Review Tab
Sparkforge alerts sub-account admins by email when a workflow throws an error and lists every broken workflow in a dedicated Needs Review tab. You configure recipients, then acknowledge errors from execution logs.
Sparkforge surfaces workflow errors two ways: an email to sub-account admins and a Needs Review tab on the workflows list. You control who gets emails, throttle the volume, and acknowledge each error from execution logs.
What's covered
Phase 1 covers errors from these actions:
- Webhook and custom webhooks.
- Premium actions: Slack, Array, custom code, ChatGPT, Google Sheets.
- Facebook: add/remove from custom audience, Conversion API, Messenger, Interactive Messenger.
- Instagram: DMs and Interactive Messenger.
Configure notifications
- Open Workflow Settings from the workflows list page.
- Toggle email notifications on. They are off by default.
- Add or remove recipients.
Review and acknowledge errors
- Open the Needs Review tab on the workflows list.
- Click any workflow to open its execution logs.
- Mark errors as read to acknowledge them.
Email behavior
- You get an email immediately when a new error fires.
- After that, Sparkforge throttles to one email per 24 hours per recipient. New errors after that window trigger another email.
- The Review it button in the email lands on the Needs Review tab.
Turn it off
Open Workflow Settings and toggle notifications off. Emails stop immediately.
Frequently Asked Questions
Who receives workflow error emails by default?
Nobody. Notifications start off. You add sub-account admin recipients explicitly in Workflow Settings.
How often will Sparkforge email me about workflow errors?
At most once every 24 hours per recipient, even if multiple errors occur. The first error after a 24-hour quiet window triggers a fresh email.
Which workflow actions generate error notifications?
Phase 1 covers webhooks, premium actions (Slack, Array, custom code, ChatGPT, Google Sheets), and Facebook/Instagram messenger actions. Coverage expands in later phases.
How do I clear an error after fixing the workflow?
Open the workflow's execution logs and mark the errors as read. The workflow drops out of the Needs Review tab.
Can I disable error emails without losing the Needs Review tab?
Yes. The toggle in Workflow Settings only controls email delivery. The Needs Review tab stays visible and functional regardless.
Was this article helpful?
Thanks for the feedback.