Capture Bounce Codes & Bounce Reasons in Salesforce

Capture and record bounce codes and bounce reasons for emails that were not received

Amanda Jaramillo avatar
Written by Amanda Jaramillo
Updated over a week ago

Capturing and recording bounce codes and bounce reasons for emails that were not received successfully can provide valuable insights into your email campaigns and activities. By identifying the reasons why recipients are not getting your emails, you can improve your email deliverability, maintain a good sender reputation, and understand technical issues that can help improve the effectiveness of your email campaigns and communications with clients.

Contents of this document:


Creating new Task fields in Activity Object

* If you have the latest Groove Insights installed, these fields should already be available to you. You do not need to create the new fields.

To download the latest Groove Insights, please visit: https://go.groove.co/download-groove-insights

To capture the bounce codes and reasons, you must perform the following actions:

  1. Follow the steps in https://help.salesforce.com/s/articleView?id=000387017&type=1 to reach the Salesforce page to create new fields for Activity object

  2. Create the following fields under the Activity object:

Field Info

Field Type

Length

Description

Info Text

field label:

Email Bounce Code

field name: email_bounce_code

text

100

Numerical representation of the reason why an email message was not delivered successfully

If this email did not reach the intended recipient, this field will contain the corresponding bounce code why this email message was not delivered

field label:

Email Bounce Code Reason

field name: email_bounce_code_reason

text area

255

Detailed explanation for the corresponding bounce code

If this email did not reach the intended recipient, this field will contain the description and/or explanation for the bounce code

* Please note that the bounce details are fields on the email activity in Salesforce, therefore, the bounced emails activities WILL NOT BE automatically deleted to capture the bounce information.

IMPORTANT: AFTER YOU HAVE CREATED THE NEW FIELDS, PLEASE REACH OUT TO YOUR CSM SO THEY CAN ENABLE THIS FEATURE


How to find the bounce codes and bounce reasons

For bounce codes and reasons to be recorded, the email sent must be logged to Salesforce

When the emails sent via Flow, One-Off Action, Gmail (for Google users) or Send With Groove (for Microsoft Outlook users) bounces, the bounce code and reason will be captured in the same Activity object as the email.

With the bounce codes, a Salesforce report can be generated to identify the emails that were not successfully delivered and the reason for the delivery failures.


Supported Bounce Codes

The following common bounce codes will be captured and recorded:

Did this answer your question?