What are Connectors?Updated 13/02/2018

Learn how to use the Hull Connector tools to capture incoming data, manage identities, and map & filter outgoing data.

Connectors enable you to manage how data syncs between Hull and 3rd party tools like Salesforce, HubSpot, Intercom, Segment, and Clearbit.

Note: Each connector works slightly differently, to adapt to the service's capabilities. Please Consult the individual connector documentation for specifics about how to configure them, their limitations, and their capabilities. Here’s the full list of connector documentation.

Viewing the list of installed Connectors

You can access Connectors from the Overview link on the left hand navigation in the dashboard. Under the “Connectors” heading, you’ll find a sortable list of every connected tool.

This includes their:

  • Type (e.g. the Hull or 3rd party tool that’s connected)
  • Title (name for the connector)
  • Status (whether data is flowing or not)
  • Current Backlog size (sparkline to show recent API calls)

How to install a connector

To add a new connector, click the + button on the top right of the Connectors tab. You’ll see an array of different tools install into your Hull Organization. Scroll or search through the different tools to connect. Click your chosen tool.

You’ll see a full screen display of the Connector’s documentation. Click Install for the Connector to be added to your Hull Organization. You’ll land on the Connector's Overview page.

Understanding the Connector Overview

From the list of all Connectors, you can click on any installed Connector to access the Connector’s Overview.

Each Connector has a name and a type. This helps with managing multiple versions of the same Connector (e.g. Processor). Keep in mind some connectors can't be installed multiple times (such as the Hubspot connector) but some can (such as the SQL importer)

The Connector Overview page will include:

  • Graph showing traffic in the past 24 hours and remaining API calls
  • Activity status of the integration (whether it has passed data in the past 24 hours)
  • Size of the current backlog on the way to the destination service (if any)
  • Changelog showing all the changes made to the connector's configuration, and who made them
  • Notifications feed, including all warnings

How to authenticate Connectors

Some connectors will sport a custom action button on the Overview Screen - The action will be different for each the connector.

For technical Connectors (like Processor or SQL Importer), this includes the JavaScript editor to manipulate customer data in real-time.

For some non-technical Connectors (like Salesforce), this includes the ability to authenticate the Connector and fetch Users & Accounts into Hull. For newer connectors, the Authentication and Credentials will be directly accessible in the Settings section

How to configure Connectors

Access the Connector Settings from the Settings tab.

Edit your name and description, and configure your data mapping and different options to define how Hull integrates with the destination service.

Click the Save button once you’ve finished editing your Integration settings. If some settings are invalid or incomplete, Hull will not let you save the settings.

When you save the settings, you can enter a "Commit Message" that lets you explain to your team what was changed and why.

Reading Connector Documentation

You can view all Integration Documentation within the Integration page under the Documentation heading.

You can also view Integration documentation at hull.io/docs/.

Connector Logs

In addition to the top-level Logs page, the connector also exposes it's own Logs tab. When accessing it, you'll be able to view the logs filtered for this connector. The Logs are a powerful and precise way to understand your exact data flow and surface the potential issues in great detail

How to Delete Connectors

To remove a connector, go onto the Connector settings, scroll all the way down to the "Danger Zone" and click Delete.