Learn how to use the Hull Connector tools to capture incoming data, manage identities, and map & filter outgoing data.
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.
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:
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.
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:
The Integrations menu includes:
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.
You can view all Integration Documentation within the Integration page under the Documentation heading.
You can also view Integration documentation at hull.io/docs/.
You can view all Integration Logs within the Integration page under Logs.
Workspace is where you manage your Integration’s data flows.
For non-technical and tool Integrations (like Salesforce), this includes the ability to connect your Integration and fetch Users & Accounts into Hull.
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.
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|
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”.
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.