Overview
Learn how to set up the sanctions.io app in Salesforce by configuring automated screening triggers, adding screening fields to your page layouts, and displaying screening alerts in related lists. This setup ensures your records are continuously monitored and screening results are visible and actionable for your team.
Topics Covered
Best Practices and Considerations
- It's recommended to disable triggers when performing bulk data insertions, such as with the Salesforce Data Loader. These records are better handled through Batch Screening, which is optimized for processing large volumes efficiently.
- Screening results are influenced by the global configuration of the sanctions.io app. Make sure your configuration aligns with your organization's compliance requirements.
-
Only matches above your configured threshold will be returned.
-
Results are limited to the lists and datasets selected in the global settings.
-
- Screening callouts from Salesforce are asynchronous, meaning there may be a short delay between record creation and the completion of screening. To confirm whether a record has already been screened, refer to the "Screened by sanctions.io" field. This field helps verify that the screening process has completed, whether triggered automatically or initiated through another method.
Enable Triggers
Trigger-based screening automatically scans leads, contacts, and accounts as they are created in Salesforce. This ensures your data is continuously monitored for compliance, keeping your records up to date and audit-ready whenever they are accessed.
Enabling triggers is simple. Go to the Settings tab within the app, check the boxes for the objects (Leads, Contacts, Accounts) you want to scan automatically on insert, and click Save.
Once enabled, Screening Alert records will automatically be created shortly after each new record is added.
Add Screening Fields to Page Layouts
We recommend adding the "Screened by sanctions.io" and "Last sanctions.io Screen Date" fields to your page layouts. These fields update automatically once the asynchronous screening callout is successfully completed, regardless of whether any alerts are found. For pop-up screenings, these fields will only update if the user saves the alerts; if the user cancels, the fields will remain unchanged.
To display the latest screening information directly on your records, follow these steps:
1. In Salesforce Setup, navigate to Object Manager and select the object you want to update (e.g., Lead, Contact, Account). 
2. In the selected object, go to Page Layouts. Choose the layout you want to edit.
3. Find the following fields in the Fields panel:
- Screened by sanctions.io
- Last sanctions.io Screen Date
Then, drag and drop both fields into a visible section of the layout. Click Save.
When Screening Fields Are Updated
These fields update with the latest timestamp whenever a successful screening result is returned, regardless of how the screening was triggered.
Trigger-Based Screening
-
Fields update automatically after a successful screening callout.
-
This applies regardless of whether alerts are found.
Pop-Up Screening (e.g., via One-Click Button)
-
Fields update only if alerts are found and saved.
-
If the user cancels, the fields do not update.
Batch Screening
-
Fields update once the batch process completes scanning.
-
They update whether results are found or not.
Add Screening Alerts to Related List
Setting up related lists on your Lead, Contact, and Account records allows users to quickly view all saved screening alerts directly from the record page.
What Are Related Lists?
Related lists are a standard Salesforce feature that display records related to the one you're currently viewing. Since Screening Alert records are automatically linked to leads, contacts, and accounts when they're created, they will appear in the related list as soon as they're added to the page layout; no additional configuration is needed.
The following setup steps are the same for all three objects (Lead, Contact, and Account). This walkthrough will use the Lead object as an example, but you can repeat the same process for the others.
1. In Salesforce Setup, go to Object Manager. Search for and select Lead (or Contact/Account, depending on the object).
2. In the left sidebar of the object setup, click Page Layouts. Choose the layout you'd like to edit (e.g., Lead Layout).
3. In the layout editor, scroll to the Related Lists section in the component panel. Then, drag the Screening Alerts related list onto the layout (typically under existing 'Related Lists').
4. Click Save in the layout editor to apply your changes. Once saved, the Screening Alerts related list will appear on the record page for users, displaying all screening alerts associated with that record.
Customize the Related List (Optional)
We recommend adding the most commonly used fields to the Screening Alerts related list to provide users with a quick, high-level overview of each screening result. For more detailed information, users can simply click into any individual Screening Alert record to view all available fields.
1. Click the wrench icon on the Screening Alerts list to customize visible columns.
2. You might include columns like Person Name (also used for account names), Data Source, Score, Compliance Audited?, and Created Date. Then, sort by the most recent Created Date.
3. Click OK to save column settings. Then, click Save in the layout editor to apply your changes.
That's it! Users can now easily view sanctions screening results directly on the record page, providing quick visibility into any potential alerts without needing to leave the layout.
❗Note: Only the first three fields you select for the related list will appear directly on the record page layout. All additional fields will be visible when users click "View All" to open the full related list table.
We're here to help!
We offer hands-on onboarding support and can guide you through configuring the integration to match your specific use case.
For any additional questions or further assistance, please don't hesitate to reach out to our support team.
-
Chat: Available directly in the portal
-
Email: help@sanctions.io
Related Articles
Getting Started with Salesforce Integration