Exception Handling in Salesforce Flow

Your flow may fail if it includes an element that interacts with the Salesforce database, such as an Update Records element, or a Submit for Approval core action. How do you handle errors in Salesforce Flow?

In this article, I’ll go over some exception handling techniques for both screen flow and auto-launched flow.


✷ What happens when a Flow fails?

When a flow fails, the user who is running it receives this error message.

An unhandled fault has occurred in this flow
An unhandled fault has occurred while processing 
the flow. Please contact your system administrator 
for more information.

The running user is unable to continue with the flow or return to a previous section of the flow. A fault email is sent to the admin who created the flow. The email describes the failed element, the error message, and which elements were executed during the failed interview.

Error element Assign_fields_values (FlowAssignment).
Flow encountered an error when processing and converting between data types. Please check the flow and ensure all data types are matched correctly.

The above flow error message indicates that an assignment element was used to insert a value into a field, but the values were not assigned based on the data type of the field. For example, you are not putting the correct record ID in the lookup field.

An error occurred at element Delete_1.
DELETE --- There is nothing in Salesforce matching your 
delete criteria.

In the preceding example, a Delete Record element in a Flow causes an error if no records matching the selection criteria are found.

↠ Salesforce publishes a Flow Execution Error Event platform event message for screen flows.

How to handle errors in Screen Flow ?

To change the default behavior of flow failures, we can use fault paths for all elements that can fail. We can deal with the error and do the following in the fault path.

Fault path
  • Add a screen element and display the flow failure message to the user.
  • Create a record in your custom Error Log object.
  • Send yourself an email in case of failure.

See how the exception in the screen flow can be handled in the video down below.


How to handle errors in Auto-launched Flow?

Salesforce does not publish Flow Execution Error Event platform event message in case of any exception in auto-launched flow. So, in order to display the user-friendly message to the user and to create an object record for the error log, we will use a custom platform event.

Create a platform event in your org.

  • Enter Label and Plural label
  • In Publish Behaviour field select ‘Publish Immediately
  • Click on Save.

Create a field to store the error message.

Check out the video below to see how the exception in the auto-lanched flow can be handled.


The custom exception class and LWC code are listed below.


import { LightningElement,api } from 'lwc';
import { subscribe, unsubscribe, onError, setDebugFlag, isEmpEnabled } from 'lightning/empApi';
import { ShowToastEvent } from 'lightning/platformShowToastEvent';
export default class ErrorMessage extends LightningElement {
subscription = {};
@api channelName = '/event/Flow_Error__e';
// connected callback : initialise
connectedCallback() {
// Register error listener
handlePESubscribe() {
// Callback invoked whenever a new platfrom event message is created.
const thisReference = this;
const messageCallback = function(response) {
var obj = JSON.parse(JSON.stringify(response));
//simplify the flow failure error message
let error_message = obj.data.payload.Error_Message_Text__c.substring(0, obj.data.payload.Error_Message_Text__c.indexOf("You can look up ExceptionCode values"));
console.log('Simplified error: '+ error_message);
//show toast message
const evt = new ShowToastEvent({
title: 'Error !',
message: error_message,
variant: 'error',
// Invoke subscribe method of empApi. Pass reference to messageCallback
subscribe(this.channelName, -1, messageCallback).then(response => {
// Response contains the subscription information on subscribe call
console.log('Subscription request sent to: ', JSON.stringify(response.channel));
this.subscription = response;
/* If you want to unsubscribe use this channel.
handleUnsubscribe() {
// Invoke unsubscribe method of empApi
unsubscribe(this.subscription, response => {
console.log('unsubscribe method response: ', JSON.stringify(response));
// Error listner method
registerErrorListener() {
onError(error => {
// Error contains the server-side error
console.log('Error received: ', JSON.stringify(error));
view raw errorMessage.js hosted with ❤ by GitHub


<?xml version="1.0" encoding="UTF-8"?>
<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
<targetConfig targets="lightning__RecordPage, lightning__AppPage, lightning__HomePage">
<property name="channelName" type="String" />


public with sharing class ExceptionUtilityCls {
public class CustomException extends Exception{}
@invocableMethod(label='Custom Exception' description='Invoke custom eception method.' category='Exception Handling')
public static void throwCustomException(List<String> exceptionMessage) {
throw new CustomException('Exception hac occured in the process /flow '+
'Please contact your system adminstrator : '+ exceptionMessage[0] );


It is always a good idea to deal with exceptions in code; the same stands true for flow. The best course of action is to plan ahead for exception/errors and incorporate proper fault handling into your flow design, which will help you handle errors more effectively when they do happen.

Join 768 other followers
  • Event-Driven Integrations Just Got Easier with the Pub/Sub API
    The Pub/Sub API provides a unified interface for publishing and subscribing to platform events such as real-time event monitoring and change data capture. Pub/Sub API efficiently publishes and delivers binary event messages in the Apache Avro format using gRPC and HTTP/2.
  • In and Not In Operators in Flows
    Salesforce’s Winter’23 release included this much-needed feature ↠ In and Not In operators in flow builder. With In and Not in operators, we can easily query the related data without writing a query inside the loop element.
  • Customize Login Experience using Login Flow
    A login flow can be used to personalize the login experience and integrate business processes with Salesforce authentication. Common use cases include displaying release/notice messages, collecting and updating user data at login, configuring multi-factor authentication, and integrating third-party strong authentication methods.


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s