Sanctions.io for HubSpot — Setup & Overview
Sanctions.io for HubSpot brings AML compliance screening natively into your CRM. Screen your contacts and companies against 60+ global sanctions lists and one of the world's largest PEP databases — directly inside HubSpot, with no data exports, no platform switching, and no manual uploads required.
Your contact data never leaves your HubSpot portal.
When a screening runs, a search query is sent to the Sanctions.io API. No contact or company records are transmitted or stored externally. Match results are returned and saved as DoSanctions Result objects within your own HubSpot portal — permanently, even if you later disconnect the app. Your data stays yours.
What gets screened
The integration screens HubSpot Contact and Company records against:
- 60+ global sanctions lists — including UN, OFAC SDN, EU CFSP, HM Treasury, and regional lists across Africa, Asia, Europe, the Middle East, North America, and South America. Lists are updated every 60 minutes.
- PEP database — included in all plans. Over 1 million Politically Exposed Person records worldwide, covering politicians, judges, military officials, senior executives, and their family members and close associates. Full PEP coverage is included in every plan at no extra cost — it is not a premium add-on.
- Criminal watchlists — Interpol Red Notices and FBI Most Wanted, included in all plans.
Before you begin
You will need:
- A HubSpot portal (any plan for manual screening; Professional or Enterprise for workflow automation)
- A Sanctions.io subscription or free 7-day trial — start at sanctions.io, no credit card required
Installation
Step 1 — Install from the HubSpot Marketplace
Go to the Sanctions.io listing on the HubSpot App Marketplace and click Install app.
During installation you will be asked which HubSpot portal to connect. A Sanctions.io trial account is created automatically and linked to that portal. No API token steps are required for a standard first install.
⚠️ If you are testing in a HubSpot Sandbox first — read this before installing.
Install into your Sandbox portal now. When you are ready to go live, do not return to the HubSpot Marketplace and install again — this creates a duplicate Sanctions.io account, not a connection to your existing one.
To move from Sandbox to Production correctly, use the Direct Install Link method. See [How to find your API token and connect it to HubSpot] for step-by-step instructions.
Step 2 — Enable the App Card on Contact and Company records ⚠️
This step is required and is the most commonly missed part of setup. The Sanctions.io App Card will not appear on records until you enable it manually.
- Go to Settings → Integrations → App Cards
- Enable Sanctions.io — Contact screening and set it to appear on the Record page default view
- Enable Sanctions.io — Company screening and set it to appear on the Record page default view
Once enabled, the App Card is visible on every Contact and Company record in your portal.
Step 3 — Configure your watchlists (optional)
All 60+ lists are enabled by default. To customise:
- Go to Settings → Integrations → Connected Apps → Sanctions.io for HubSpot
- Open List Selection
- Deselect any lists that are not relevant to your compliance requirements
If you are unsure, leave all lists enabled. See [Setting up watchlists — choosing which lists to screen against] for guidance.
Step 4 — Set up workflow automation (optional)
Workflow actions for Screen Contact and Screen Company are available immediately after installation. Use these to automatically screen new contacts, trigger compliance checks at deal stages, or run periodic re-screening across your database.
Requires HubSpot Professional or Enterprise. See [Automating sanctions screening with HubSpot workflows] for step-by-step setup.
Running your first screening
Open any Contact or Company record in HubSpot. You will see the Sanctions.io App Card in the record panel. Click Screen Now to run an immediate screening.
Results are returned within seconds. Each match is stored as a DoSanctions Result object linked to the record, a PDF is attached to the timeline, and a HubSpot App Event is logged.
Evaluation period note: New accounts include a 200-screening allowance for workflow and scheduled screenings. The Screen Now button is not subject to this limit and can be used freely throughout your trial.
What happens after a screening
| Sanctions Status | Meaning |
|---|---|
| (blank) | Contact has never been screened |
| In Review | One or more matches found — review required |
| Whitelisted | Screened and cleared |
| Blacklisted | Confirmed sanctions match |
Your compliance team reviews each DoSanctions Result, records a decision (Whitelisted, False Positive, In Review, or Blacklisted), and optionally adds a Decision Remark. Every decision is logged to the HubSpot timeline as a permanent audit trail.
Plans and pricing
All plans include the same features — sanctions lists, PEP database, criminal watchlists, and full API access. Plans differ only in the number of screenings per year.
| Plan | Screenings/year | Annual price |
|---|---|---|
| SMALL | 10,000 | $3,660 |
| MEDIUM | 50,000 | $6,900 |
| LARGE | 250,000 | $11,625 |
All plans include a 7-day free trial. Billing is managed directly by Sanctions.io — not through the HubSpot Marketplace. For pricing queries or a custom proposal, contact help@sanctions.io.
Support
- Sanctions.io support: help@sanctions.io — billing, accounts, and API
Support is available in English, Spanish, German, and Portuguese.