It is possible to define a specific sending-safe list at the sandbox level, to have a secured environment for testing purpose.
For example, on a non-production instance, where mistakes can occur, the allowed list ensures you have no risk of sending out unwanted messages to your customers.
This feature is available on production and non-production sandboxes.
The allowed list enables you to specify individual email addresses or domains that will be the only recipients or domains authorized to receive the emails you are sending from a specific sandbox. This can prevent you from sending emails accidentally to real customer addresses when you are in a testing environment.
This feature only applies to the email channel.
To access the detailed list of allowed email addresses and domains, go to Administration > Channels > Email configuration, and select Allowed list.
To export the allowed list as a CSV file, select the Download CSV button.
Use the Delete button to permanently remove an entry.
You can search on the email addresses or domains, and filter on the Address type. Once selected, you can clear the filter displayed on top of the list.
To enable the allowed list, follow the steps below.
Access the Channels > Email configuration > Allow list menu.
Click Enable/Disable allowed list.
Select Enable allowed list.
Click Save. The allowed list is enabled.
The allowed list logic applies when the feature is enabled. Learn more in this section.
The allowed list can contain up to 1,000 entries.
You can manually populate the Journey Optimizer allowed list by adding an email address or a domain through the user interface.
You can only add one email address or domain at a time.
To do this, follow the steps below.
Select the Add email or domain button.
Choose the address type: Email address or Domain address.
Enter the email address or domain you want to send emails to.
Make sure you enter a valid email address (such as firstname.lastname@example.org) or domain (such as abc.company.com).
Specify a reason if needed.
All ASCII characters comprised between 32 and 126 are allowed in the Reason field. The full list can be found on this page for example.
To populate the allowed list, you can also call the suppression API with the
ALLOWED value for the
listType attribute. For example:
You can perform the Add, Delete and Get operations.
Learn more on making API calls in the Adobe Experience Platform APIs reference documentation.
When the allowed list is enabled, the following logic applies:
If the allowed list is empty, no email will be sent out.
If an entity is on the allowed list, and not on the suppression list, the email can be sent to the corresponding recipient(s). However, if the entity is also on the suppression list, the corresponding recipient(s) will not receive the email, the reason being Suppressed.
If an entity is not on the allowed list (and not on the suppression list), the corresponding recipient(s) will not receive the email, the reason being Not allowed.
The profiles with Not allowed status are excluded during the message sending process. Therefore, while the Journey reports will show these profiles as having moved through the journey (Read Segment and message activities), the Email reports will not include them in the Sent metrics as they are filtered out prior to email sending.
When this feature is enabled on a non-production sandbox, you can retrieve email addresses or domains that were excluded from a sending because they were not on the allowed list. To do this, you can use the Adobe Experience Platform Query Service to make the API calls below.
To get the number of emails that were not sent because the recipients were not on the allowed list, use the following query:
SELECT count(distinct _id) from cjm_message_feedback_event_dataset WHERE _experience.customerJourneyManagement.messageExecution.messageExecutionID = '<MESSAGE_EXECUTION_ID>' AND _experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus = 'exclude' AND _experience.customerJourneyManagement.messageDeliveryfeedback.messageExclusion.reason = 'EmailNotAllowed'
To get the list of email addresses that were not sent because the recipients were not on the allowed list, use the following query:
SELECT distinct(_experience.customerJourneyManagement.emailChannelContext.address) from cjm_message_feedback_event_dataset WHERE _experience.customerJourneyManagement.messageExecution.messageExecutionID IS NOT NULL AND _experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus = 'exclude' AND _experience.customerJourneyManagement.messageDeliveryfeedback.messageExclusion.reason = 'EmailNotAllowed'