Importing Contacts as Suspects

Overview

The HubSpot integration allows you to import contacts from one or more HubSpot accounts into M-Power as Suspects. This is a one-way import — contacts flow from HubSpot into M-Power, where you can review them and convert them into Companies and Contacts as needed.

Each import pulls contacts created in HubSpot within the last 7 days. Contacts that have already been imported are automatically skipped, so you can run the import as often as you like without creating duplicates.

Prerequisites

Before you begin, you'll need a HubSpot Private App with an access token. If you don't have one yet:

1. Log in to your HubSpot account and navigate to Settings > Integrations > Private Apps.
2. Click Create a private app.
3. Give it a name (e.g. "M-Power Integration").
4. Under the Scopes tab, grant Read access to both Companies and Contacts. Read access is sufficient — no write permissions are needed.
5. Click Create app and copy the generated Access Token. You'll need this for the M-Power configuration.

For more details on Private Apps, see the HubSpot Private Apps documentation.

Setting Up the Integration

1. In M-Power, go to Settings > Integrations.
2. Click the Add Integration button and select Hubspot Contact Import from the dropdown.
3. You'll be taken to the configuration page with these fields:
   • Instance Name — A friendly label to identify this HubSpot connection (e.g. "Production HubSpot", "AU Sales Hub"). This is especially useful if you connect multiple HubSpot accounts.
   • Private App Token — Paste the access token you copied from your HubSpot Private App.
4. Click Save.

Testing the Connection

After saving, click the Test Integration button. M-Power will attempt to connect to HubSpot using your token and retrieve a sample of contacts. The test results are displayed in a log panel below the button.

• If the test succeeds, you'll see details about the contacts retrieved.
• If it fails, check that your token is correct and that the Private App has the required Read scopes for Companies and Contacts.

Importing Contacts

Once the integration is configured and tested:

1. Navigate to Me > Suspects.
2. Click the Import button (dropdown).
3. Select the HubSpot integration instance you want to import from.
4. The import will run and display a summary showing:
   • How many contacts were imported (new Suspects created)
   • How many were skipped (already imported previously)
   • The total number of contacts processed

What Gets Imported

Each HubSpot contact is mapped to a Suspect record with the following fields:

Imported Suspects are automatically assigned:

• Source: "Hubspot"
• Status: "New"
• Notes: "Imported from Hubspot"

Duplicate Detection

The import uses HubSpot's hs_object_id (stored in the Suspect's External Reference field) to detect duplicates. If a contact has already been imported, it will be skipped on subsequent imports.

Working with Imported Suspects

After import, your new Suspects will appear in the Me > Suspects list. From there you can:

• Review the contact details
• Convert a Suspect into an M-Power Company and/or Contact when you're ready to engage with them
• Update the Suspect status as they move through your pipeline

Managing the Integration

Viewing Sync History

On the integration settings page, the Log panel shows the timestamp and result of the last import (e.g. "OK — Imported 3 contacts, 2 skipped").

Multiple HubSpot Accounts

You can configure multiple HubSpot integrations, each with a different Instance Name and Private App Token. They will all appear as separate options in the Import dropdown on the Suspects page.

Deleting the Integration

On the integration settings page, click the Delete button in the red panel at the bottom-right. You'll be asked to confirm — this action cannot be undone. Deleting the integration removes the configuration only; any previously imported Suspects are not affected.

Troubleshooting

FAQ

Q: Does M-Power push any data back to HubSpot? No. This is a read-only, one-way import. No data is written back to HubSpot.

Q: How far back does the import look? The import retrieves contacts created in the last 7 days.

Q: Can I import companies or deals from HubSpot? Currently only contacts are supported. They are imported as Suspects which can then be converted to Companies and Contacts within M-Power.

Q: What permissions does the Private App need? Read access to Companies and Contacts. No write permissions are required.