List Armor

HubSpot Integration

Automatically sync unsubscribes, bounces, and spam complaints from HubSpot to your suppression lists.

On this page

Overview

The HubSpot integration uses workflow webhooks to automatically add email addresses to your suppression lists when contacts unsubscribe, bounce, or mark emails as spam.

Workflow-Powered

Flexible automation triggers

CRM Integration

Full contact context

Auto-Suppress

Configurable event handling

Prerequisites

  • A HubSpot account with Marketing Hub Professional or Enterprise
  • Access to create workflows in HubSpot
  • A List Armor campaign with at least one suppression list
Note: HubSpot webhook actions require Marketing Hub Professional or Enterprise. Free and Starter plans don't support webhooks in workflows.

Setup in List Armor

  1. Navigate to your campaign and click ESP Integrations
  2. Click Add Integration and select HubSpot
  3. Choose the Target Suppression List where opt-outs will be added
  4. Configure which events to auto-suppress:
    • Hard bounces — recommended
    • Spam complaints — recommended
    • Unsubscribes — recommended
  5. Save the integration and copy the Webhook URL

Configure HubSpot

HubSpot uses workflows to trigger webhooks. You'll create separate workflows for each event type.

Unsubscribe Workflow

  1. Go to Automation → Workflows
  2. Click Create workflow → From scratch
  3. Select Contact-based workflow
  4. Set enrollment trigger: Contact property → Unsubscribed from all email → is true
  5. Add action: Trigger a webhook
  6. Method: POST
  7. URL: Paste your List Armor webhook URL
  8. Include all contact properties in the request
  9. Save and turn on the workflow

Hard Bounce Workflow

  1. Create a new contact-based workflow
  2. Set enrollment trigger: Contact property → Email hard bounce reason → is known
  3. Add the same webhook action with your List Armor URL
  4. Save and turn on the workflow

Spam Complaint Workflow

  1. Create a new contact-based workflow
  2. Set enrollment trigger: Contact property → Marked email as spam → is true
  3. Add the same webhook action with your List Armor URL
  4. Save and turn on the workflow
Important: Set each workflow's re-enrollment settings to prevent duplicate webhooks for the same contact.

Supported Events

HubSpot Trigger List Armor Action Default
Email hard bounce reason is known Add to suppression list Enabled
Marked email as spam is true Add to suppression list Enabled
Unsubscribed from all email is true Add to suppression list Enabled

Testing

After configuring the workflows, verify they're working:

  1. Create a test contact in HubSpot
  2. Manually set the "Unsubscribed from all email" property to true
  3. Check the workflow history to confirm it triggered
  4. Check your List Armor integration for the Last webhook received timestamp
  5. Verify the email appears in your target suppression list
Tip: Use HubSpot's workflow test feature to manually enroll a contact and verify the webhook fires.

Troubleshooting

  • Webhook actions require Marketing Hub Professional or Enterprise
  • Check your HubSpot subscription level
  • Contact HubSpot support to verify your account has webhook access

  • Verify the workflow is turned on
  • Check that the enrollment trigger is correct
  • Ensure the contact meets the trigger criteria
  • Check re-enrollment settings if testing the same contact multiple times

  • Verify the webhook URL is correct
  • Check that "Include all contact properties" is enabled
  • Ensure the contact has an email address property
  • Check List Armor integration logs for processing errors

Need Help?

Having trouble with your HubSpot integration? Our support team can help.

Contact Support