Inbox Spam Filter Setup Guide

Inbox Spam Filter connects to your HubSpot shared inboxes and uses AI to score incoming messages, flag spam, and optionally mark matching contacts with the spam_filter_status property. Use this guide before and after installing so you know the full journey: install, configure, use, disconnect, and uninstall.

What you need

  • A HubSpot account with permission to install connected apps
  • Access to the shared inboxes you want to monitor

Install the app

1. Start the install

Open Inbox Spam Filter from the HubSpot Marketplace (or your install link) and click Install / Connect app. The HubSpot login and account picker open in a new window so you can keep this guide open.

2. Log in to HubSpot

Sign in with your usual HubSpot credentials. There is no separate Inbox Spam Filter login.

HubSpot login screen during app install
Click to enlarge — HubSpot login

3. Select your HubSpot account

If you belong to more than one HubSpot account, choose the portal where shared inboxes should be filtered. Single-account users usually skip this step.

Select HubSpot account during install
Click to enlarge — select account

4. Confirm permissions (OAuth scopes)

Review the permissions Inbox Spam Filter requests. The app needs access to read and update contacts so it can set spam_filter_status when spam is detected, and to work with your connected inbox data. Click Connect app to approve.

After approval you are returned to HubSpot with Inbox Spam Filter listed under Settings → Integrations → Connected Apps.

HubSpot OAuth scope approval screen
Click to enlarge — OAuth permissions

Configure the app

Open Connected Apps, select Inbox Spam Filter, then go to Settings → Scoring.

  1. Set the Spam threshold (1–100, default 70). Messages at or above this score are treated as spam.
  2. Optionally add Whitelist domains that should always skip AI scoring.
  3. Choose Inboxes to analyze, or leave empty to monitor all connected shared inboxes.
  4. Set Mark contact as spam (recommended: Custom property spam_filter_status).
  5. On Basic or Pro, add Custom instructions for the AI if you need business-specific rules.
  6. Click Save.

Optional next steps:

Inbox Spam Filter Scoring settings
Click to enlarge — Scoring settings

Use the app

Automated: After install and save, Inbox Spam Filter scores new messages in the selected shared inboxes. When a message meets your threshold, it appears on the Overview dashboard and contacts can be marked via spam_filter_status if that option is enabled.

Manual: Open the app → Overview to review flagged messages, scores, and AI reasoning. Search and refresh as needed.

See also: Review filtered spam on the dashboard and Understanding scores and reasoning.

Inbox Spam Filter Overview dashboard with scores and reasoning
Click to enlarge — Overview dashboard

Disconnect the app

Disconnecting stops Inbox Spam Filter from analyzing new inbox messages and from updating contact properties. Existing HubSpot contacts, conversation history, and any spam_filter_status values already written remain in your portal unless you change or clear them yourself.

  1. In HubSpot, go to Settings → Integrations → Connected Apps.
  2. Select Inbox Spam Filter.
  3. Choose to disconnect or uninstall the app, then confirm.

Uninstall the app

To uninstall Inbox Spam Filter from HubSpot, follow HubSpot’s guide: Connect and manage apps in HubSpot (Connected Apps → uninstall).

  • Uninstalling removes the connected app from the portal.
  • It does not delete your HubSpot CRM records or shared-inbox messages.
  • Historical rows in the Inbox Spam Filter dashboard may no longer be available after uninstall.
  • If you had a paid plan, cancel or adjust billing in the app’s Billing tab before uninstall, or contact us.

You can reinstall later from the Marketplace and go through this setup guide again.

Ready to stop spam in your HubSpot inbox?

Install the app in minutes. No credit card required for the free Starter plan.

No HubSpot Account? Get It Free!