ANS-0237 · CUSTOMER & CRM RECORDS

How to Track Soft Bounces for Emails in NetSuite Campaigns

Understand NetSuite's email bounce categories and how to leverage saved searches to monitor delivery issues for campaign emails.

Short answer

NetSuite enables tracking of soft bounces for campaign emails using saved searches to expose detailed bounce information. While specific error codes and classifications may vary, understanding general bounce categories like Hard Bounce, Soft Bounce, and potentially Block or Technical helps diagnose email delivery issues and optimize campaign performance.

Scenario

Users managing email campaigns in NetSuite often need to understand why certain emails are not delivered. Specifically, there is a need to track 'soft bounces' to identify temporary delivery issues, which differ from permanent 'hard bounces'. The challenge lies in accessing detailed bounce information and understanding the various error codes that NetSuite may report.

Solution

NetSuite provides capabilities to track soft bounces for emails, particularly those sent from campaigns, by utilizing saved searches to expose detailed bounce information.To track soft bounces for campaign emails:

  1. Configure a saved search for your email campaigns.

  2. Include fields in the search results that display 'Details of the Bounce' or similar bounce-related information.When sending bulk mail through NetSuite's infrastructure, various bounce categories and associated codes may be encountered. The specific error codes and their classifications can vary based on the underlying email service provider and its current configurations.Common email bounce categories include:BlockMessages unable to be delivered due to filters or user-generated complaints. Historically, or depending on the specific email service configuration, examples of such classifications could include:1001 Spam Content1002 Blacklisted1003 ISP Block1004 Content Filter1005 Spam URL1006 Excess Traffic1007 Security Violation/Virus1008 Misconfig Block1009 List Practices1010 Authentication1011 User Initiated Block1999 Blocked – OtherHard BouncePermanently undeliverable because the address is invalid or the recipient's mail server is blocking the sender's server.2001 Unknown User2002 Bad Domain2003 Address Error2004 Account Closed2999 Hard Bounce – OtherSoft BounceThe mail server recognizes the address but cannot deliver the message temporarily. Most mail servers will retry messages that soft-bounce, but delivery is not certain.3001 Mailbox Full3002 Disabled Account3003 Greylisted3004 Server Too Busy3999 Soft Bounce – OtherTechnicalIndicates issues such as data format or network errors. Historically, or depending on the specific email service configuration, examples of such classifications could include:4002 Data Format Error4003 Network Error4004 Receiver Error4006 Config Error4999 Technical - OtherFor transactional emails and those originating from third-party SMTP servers, NetSuite may process or historically processed incoming SMTP error messages (typically 4.X.X and 5.X.X codes) and categorize them into internal bounce types. The specific translation logic and resulting internal classifications can vary and are not always publicly documented.Categorization of SMTP Error Messages:Hard bounces:UNKNOWN_USER(2001)BAD_DOMAIN(2002)ADDRESS_ERROR(2003)ACCOUNT_CLOSED(2004)HARD_BOUNCE_OTHER(2999)Soft bounces:MAIL_BOX_FULL(3001)ACCOUNT_DISABLED(3002)SERVER_TOO_BUSY(3004)SOFT_BOUNCE_OTHER(3999)NETWORK_ERROR(4003)TECHNICAL_OTHER(4999)Example Mapping of SMTP Codes to Internal Bounce Types:4.0.0 > SOFT_BOUNCE_OTHER4.1.0 > SOFT_BOUNCE_OTHER4.1.4 > SOFT_BOUNCE_OTHER4.1.7 > SOFT_BOUNCE_OTHER4.1.8 > SOFT_BOUNCE_OTHER4.2.0 > SOFT_BOUNCE_OTHER4.2.1 > ACCOUNT_DISABLED4.2.2 > MAIL_BOX_FULL4.2.4 > SOFT_BOUNCE_OTHER4.3.0 > SOFT_BOUNCE_OTHER4.3.1 > SOFT_BOUNCE_OTHER4.3.2 > SOFT_BOUNCE_OTHER4.3.3 > SOFT_BOUNCE_OTHER4.4.0 > NETWORK_ERROR4.4.1 > NETWORK_ERROR4.4.2 > NETWORK_ERROR4.4.3 > NETWORK_ERROR4.4.4 > NETWORK_ERROR4.4.5 > SERVER_TOO_BUSY4.4.6 > NETWORK_ERROR4.4.7 > NETWORK_ERROR5.0.0 > HARD_BOUNCE_OTHER5.1.0 > SOFT_BOUNCE_OTHER5.1.1 > UNKNOWN_USER5.1.2 > BAD_DOMAIN5.1.3 > ADDRESS_ERROR5.1.4 > HARD_BOUNCE_OTHER5.1.6 > HARD_BOUNCE_OTHER5.1.7 > HARD_BOUNCE_OTHER5.1.8 > HARD_BOUNCE_OTHER5.2.0 > SOFT_BOUNCE_OTHER5.2.1 > ACCOUNT_CLOSED5.2.3 > SOFT_BOUNCE_OTHER5.2.4 > HARD_BOUNCE_OTHER5.3.0 > SOFT_BOUNCE_OTHER5.3.2 > HARD_BOUNCE_OTHER5.3.3 > SOFT_BOUNCE_OTHER5.3.4 > SOFT_BOUNCE_OTHER5.3.5 > SOFT_BOUNCE_OTHER5.4.0 > NETWORK_ERROR5.4.4 > NETWORK_ERROR5.4.6 > NETWORK_ERROR

Expert NetSuite Support

Need help with this NetSuite issue?

Customer & CRM Records consulting and configuration support

Talk to a consultant