Swallow
  • YOUR FIRST MODEL
    • Setting up your first project
    • Manual setup of a new product
    • Excel Model Upload
    • Create your team
    • Essential concepts
      • Syntax
      • Steps
      • Collections
      • Try Model
      • Spotlight
  • PROCESS
    • Team Management
    • Governance & Collaboration
  • BUILD
    • Building with AI
    • Step builder
      • Understanding step types
      • Ordering step blocks
      • Placeholder mode
      • Up/Downloading models
      • Sharing your model
      • Running tests
    • Inputs
    • Enriching Raw Data
      • Transform Data
      • Enrich via API
      • Data Set
      • Collection
      • Custom Code
    • Setting Up Decisions
      • Exclusions
      • Excesses
      • Endorsements
      • Refer
    • Making Calculations
      • Factors
      • Calculation
    • Outputs
  • TEST
    • Creating New Tests
    • Running Tests
    • Editing Tests
    • Reading & Interpreting Tests
    • Impact Testing
  • DATA
    • Working with real-time data
    • Data Views
    • Data Quotas
    • Troubleshooting
    • API Webhooks
    • Data Downloads
  • ADMIN & SETTINGS
    • Project Management
    • Account Management
  • INTEGRATIONS
    • Introduction
    • Payments
      • Stripe
      • GoCardless
      • Adyen
    • Alerting
      • Slack
      • Zapier
    • Data
      • AWS S3
      • Google Sheets
    • Admin
      • Socotra
      • Guidewire
      • Hubspot
      • Salesforce
  • Developer API
    • Introduction
    • Authentication
    • Errors codes
    • Endpoints
      • /quotes
      • /projects
      • /tests
      • /process
Powered by GitBook
On this page
  • Installation of App Instances
  • Triggers and Actions
  • Flows and Automation
  • Available Flows
  • Customer Reference and Company Reference
  1. INTEGRATIONS
  2. Admin

Hubspot

The Swallow and HubSpot Integration supports bidirectional sync between Swallow and HubSpot.

PreviousGuidewireNextSalesforce

Last updated 4 months ago

The integration between HubSpot and Swallow requires only a one-time setup. Follow the steps below:

Installation of App Instances

  1. Navigate to the Integrations page in Swallow Settings

  2. Click on the Connect to Hubspot button

  3. Provide a name for the connection and authenticate with your HubSpot account

  4. Repeat the same process for Swallow, treating it as a separate App within the integration.

Note: Swallow is considered an app in our integration so it is easy for you to configure different API keys for different flows. This way you can have specific permissions configured for a specific key, making it more secure. To create an API key for Swallow, go to the Settings page. Click on the API Keys tab. Then click on the 'Generate new API key' button.

Triggers and Actions

There are several Triggers and Actions available for both HubSpot and Swallow. The way it works is:

If {trigger}, then do {Action}

You can pick and choose the trigger and action that you want from the list available from all the applications.

You can use these as building blocks to build your own flows.

An example flow would be: On creation of a deal in HubSpot, create a subscription in Swallow.

Flows and Automation

To enable flows:

  1. Access the Flows section within Integrations

  2. Select the desired flow from the available options or create a new flow to meet your requirements

To create a new flow:

  1. Enter the flow name and description

  2. Select the flow type from the dropdown

    • Inbound Flow - based on third party events (e.g., HubSpot), actions are triggered in Swallow

    • Outbound Flow - based on events occurring in Swallow, changes are made to the connected third party app

  3. Define triggers by choosing the source application from where the flow starts

  4. Select a predefined trigger from the dropdown list

  5. Next, define an action which makes the desired changes by selecting the destination app

  6. Select a predefined action from the dropdown list. You can add multiple actions.

  7. Lastly, preview the flow and save changes

Alternatively, choose an existing flow and select +Add Connection. Configure the triggers and actions by specifying the app instance (HubSpot or Swallow) associated with each step.

Available Flows

Here are some out-of-the-box flows that you can use:

  1. Sync HubSpot Company to Swallow Customer

    • A new company is created in HubSpot

    • Swallow then creates a corresponding customer for it

    • You can see this mapping of HubSpot company ID in the Settings for each customer in Swallow

  2. Deal Sync to create Subscription in Swallow

    • Create a deal in HubSpot

    • Create a corresponding Subscription in Swallow

    • Associate the subscription with that particular customer

    • Deal ID is added as a property for that Subscription

Customer Reference and Company Reference

To refer to customers in HubSpot or Swallow, you can obtain the customer reference and company reference.

  • In Swallow, go to Customers, select a customer, and find the customer_reference and company_reference under Settings.

  • Use these references to link the customer in HubSpot, or vice versa.

This correction ensures that the guide accurately reflects the terminology and identifiers used in Swallow. The customer_reference and company_reference are indeed the correct terms to use when referring to customers and companies in Swallow, and these can be used to establish the connection with HubSpot entities.