Skip to main content

👥 Integrating MANTA with HubSpot

This tutorial explains how to integrate the app with HubSpot in order to automatically create contacts.

Prerequisites​

Before integrating the MANTA with HubSpot, ensure you have:

  • Running app instance (local or deployed)
  • An active HubSpot account
  • Permission to create Legacy Apps in HubSpot
note

If you already have a HubSpot Legacy App with the correct permissions, you can skip app creation and use its Access Token directly.

Integration Steps

Step 1: Create a HubSpot Legacy App​

  1. Log in to your HubSpot account
  2. Click the Settings icon
  3. Navigate to Integrations → Legacy Apps
  4. Click Create legacy app

Step 2: Set App Permissions (Scopes)​

In the Scopes section, enable the following permissions:

  • crm.objects.contacts.read
  • crm.objects.contacts.write

These scopes allow the app to:

  • Check if a contact already exists
  • Create new contacts in HubSpot

Click Create app when finished.

Step 3: Copy the Access Token​

After creating the Legacy App:

  • Copy the Access Token

Step 4: Configure HubSpot in app​

To enable HubSpot integration, configure the following environment variables:

ENABLE_HUBSPOT=true

HUBSPOT_SECRET_KEY=""
HUBSPOT_LEAD=""

HUBSPOT_SECRET_KEY - Access token used to authenticate with the user’s HubSpot account. HUBSPOT_LEAD - Tag used to identify contacts created through the app.