HubSpot Sink Connector

The HubSpot Sink Connector allows you to send events from the GlassFlow pipeline directly to HubSpot via HubSpot Private Apps Webhooks.
This integration enables real-time lead capture, contact updates, and automation triggers in your HubSpot CRM.

Connector Details

To configure the HubSpot Sink Connector, you will need the following details:

• HubSpot Private App Access Token: Required for authentication when sending data to HubSpot.
• HubSpot API Endpoint URL: The specific URL to send data, depending on your use case.
• Message Format: JSON payload formatted to match HubSpot's API requirements.

Create a HubSpot Private App & Obtain an Access Token

1. Log in to HubSpot and navigate to Settings → Integrations → Private Apps.

2. Click Create a private app, provide a name, and configure the required scopes:

   • crm.objects.contacts.write (for adding/updating contacts)
   • crm.objects.companies.write (for company-related data)
   • crm.schemas.custom.write (if dealing with custom objects)

3. Generate an Access Token and copy it. This token is required to authenticate requests.

4. Identify the appropriate HubSpot API endpoint for your integration:

   HubSpot has an extensive list of API endpoints built using REST and returning standard JSON responses, making it ideal for use with GlassFlow. Some possible operations include:

   • Add a New Contact:
     📌 API docs Create a contact
   • Permanently Delete a Contact (GDPR-compliant):
     📌 API docs GDPR Delete
   • Update an Existing Contact:
     📌 API docs Update Contact

Setting Up the HubSpot Sink Connector

Using WebApp

1. Log in to the GlassFlow WebApp and navigate to the "Pipelines" section.
2. Create a new pipeline.
3. Configure the Data Sink:
   • Choose "Webhook" as the connector type under the Data Sink configuration.
   • Enter the HubSpot API Endpoint URL obtained earlier.
   • Set HTTP Method to POST.
   • Configure the Request Headers:
     • Authorization: Bearer YOUR_HUBSPOT_ACCESS_TOKEN
     • Content-Type: application/json
   • Define the Payload to match HubSpot’s API format.
4. Click Next Step and confirm your pipeline configuration.

Using Python SDK

If you are using the GlassFlow Python SDK to deploy and manage the pipeline, the following code shows how to configure the HubSpot connector via the SDK:

Using GitHub Actions

If you are using GitHub Actions to deploy and manage the pipeline, the following snippet shows the YAML configuration of the HubSpot sink connector component:

Expected Data Structure

HubSpot's API expects contact data in the following format:

For sending data to a HubSpot form, use the following format:

Example Use Cases

• Lead Generation: Automatically push new leads into HubSpot CRM.
• Customer Engagement: Update existing contacts with real-time data.
• Marketing Automation: Trigger HubSpot workflows when new events are received.

With this setup, your GlassFlow pipeline can seamlessly send events and updates directly to HubSpot, keeping your sales and marketing teams informed in real time!