ConnectorsUpdated 13/02/2018


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


The Integrations Tool enables you to manage how data syncs between Hull and 3rd party tools like Salesforce, HubSpot, Intercom, Segment, and Clearbit.

Note: Each integration works differently. Consult the individual integration documentation for specifics about how to configure individual integrations, their limitations, and their capabilities. Here’s the full list of connector documentation.

Manage Integrations

View all Integrations

You can access Integrations 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)
  • Notifications (to review)
  • Service API calls (sparkline to show recent API calls)

Add new Integrations

To add a new Integration of any type, click the + button by “Connectors”. 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 Integration’s documentation. Click Install for the Integration to be added to your Hull Organization. You’ll land on the Integrations Overview page.

View Integrations Overview

From the list of all Integrations in the Overview tab in the left hand navigation, you can click on any installed Integration to access the Integration’s Overview.

Each Integration has a name and a type. This helps with managing multiple versions of the same Integration (e.g. Processor).

The Integrations 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)
  • List of Attributes collected at User and Account level (from the tool, written into Hull)
  • Notifications feed, including all warnings

The Integrations menu includes:

  • Overview
  • Settings
  • Documentation
  • Logs
  • Workspace

Hull Integrations Overview

Configure Integration Settings

Access the Integration Settings from Settings in the Integration page.

Edit your name and description, and configure any data mapping between the Integration and your 3rd party tools.

Click the Save button once you’ve finished editing your Integration settings.

Hull Integrations Settings

View Integration 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/.

View & Query Integration Logs

You can view all Integration Logs within the Integration page under Logs.

Configure Integration Workspace

Workspace is where you manage your Integration’s data flows.

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

For non-technical and tool Integrations (like Salesforce), this includes the ability to connect your Integration and fetch Users & Accounts into Hull.

Delete Integrations

Best practice: Never remove Integrations that have ever synced data. This preserves the logs and data flow.

To remove any Integration, go onto the Integration overview and click the menu next to the integration name and select Delete. Click OK on the confirmation dialog. Delete Integrations cannot be recovered.

Hull Integrations Delete

Data Mapping

Most integrations will pick up default data when integrated with Hull and write it in as a group of Traits and a stream of Events.

Data type Data mapping When it enters Hull
Traits, Attributes, Properties Only custom fields When the User is created, or the Trait first created or updated
Events None When the Event happens (only).
Segments None When the first matching User is created

Mapping custom data to Traits in Hull

If you have created custom fields in a third party tool, you need to map this non-standard data to Traits in Hull.

Under Settings, you will find your blocks to manage your field mapping. Depending on your precise Integration, there will be a block of fields for matching custom fields “to Hull”.

Whitelisting data to sync from Hull

You need to map all data in Hull to your other tools. This includes Traits, Events, and Segments.

In general, this involves whitelisting. Nothing is synced except for the specified fields and segments.

If creating new fields in an end tool, you may need to create custom fields (particularly in older tools) in the end tool first, instead of creating new fields in third party tools from Hull automatically.