You are here:
Troubleshoot Processes
Use the error messages that appear in the Process Builder and the emails you receive when a process fails to help solve problems that arise when you’re working with processes. When all else fails, look at the Apex debug logs for your processes.
Required Editions
| Available in: both Salesforce Classic (not available in all orgs) and Lightning Experience |
| Available in: Essentials, Professional, Enterprise, Performance, Unlimited, and Developer Editions |
Important Support and updates for Process Builder have ended as
of December 31, 2025. This means that support won't be provided for any process and bugs in
the Process Builder product won't be fixed. See Workflow Rules & Process Builder End of Support.
After December 31, 2025, existing processes continue to run, and you can activate, deactivate, and edit them; however, we recommend using Flow Builder. To migrate existing processes, plan your switch to Flow Builder and use the Migrate to Flow tool. For new automations, create flows in Flow Builder.
- Common Reasons Why Processes Fail
Here are some common design problems that cause processes to fail. - Errors in the Process Builder
The API names for criteria nodes and actions are created in the background. When you create or update processes, you can see error messages that reference those names to help you identify specifically where the problem occurred. - What Happens When a Process Fails?
When a user does something that triggers a process, such as create a record, and the process fails, the user gets an error message. The error message includes the process name, error ID, and sometimes technical information that the user can give to you, the Salesforce admin. You can use the error ID to locate the detailed error email that is sent when the process failed. - Troubleshoot Processes with Apex Debug Logs
Use debug logs to find detailed information about your running processes after they finish running. For example, investigate why a process doesn’t to trigger when a record meets the process’s criteria, or explore the sequence of processes being executed. - Send Alerts When a Screen Flow Fails
To save time troubleshooting screen flows that fail, subscribe to the Flow Execution Error Event platform event. When a flow interview fails, Salesforce publishes a platform event message. In Process Builder, you can subscribe to the platform event and perform actions, such as posting to Chatter or sending custom notifications.
Did this article solve your issue?
Let us know so we can improve!
