Hightouch

Reverse ETL and composable CDP platform that syncs data from your data warehouse to business tools for activation.

⚠️

This integration is currently in beta. Configuration and behaviour may change.

Prerequisites

Complete these steps in Hightouch before configuring Signal.

Access your Hightouch account

Log in to the Hightouch dashboard at app.hightouch.com. If you do not have an account, sign up or contact your Hightouch representative.

Create or select a workspace

If you have multiple workspaces, select the one you want to use. Note your Workspace ID from the URL or from Settings > Workspace. The workspace ID is the numeric value in the dashboard URL (e.g. app.hightouch.com/workspaces/12345).

Set up an HTTP Events source

Navigate to Sources and click Add Source. Select HTTP Events as the source type. Give it a descriptive name (e.g. “Datafly Signal Events”) and complete the setup. After creation, note the Source ID from the source detail page.

Generate an API key

Go to Settings > API Keys and click Create API Key. Provide a name (e.g. “Datafly Signal”) and assign appropriate permissions. Copy the API key immediately — it will not be shown again.

Configuration

Field	Type	Required	Description
`api_key`	secret	Yes	Your Hightouch API key. Generated in Settings > API Keys.
`workspace_id`	string	Yes	Your Hightouch workspace ID. Found in Settings > Workspace or the dashboard URL.
`source_id`	string	Yes	The HTTP Events source ID to send events to. Found on the source detail page.

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find Hightouch or filter by CDP.
Click Install, and fill in the required fields with the credentials gathered above.
Click Install Integration to create the integration with a ready-to-use default configuration.

API Setup

curl -X POST http://localhost:8084/v1/admin/integration-catalog/hightouch/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Hightouch",
    "variant": "default",
    "config": {
      "api_key": "xxxxxxxxxxxxxxxxxxxx",
      "workspace_id": "ws-12345",
      "source_id": "src-12345"
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

Signal events are mapped to Hightouch HTTP Events as follows:

Signal Event	Hightouch Concept	Notes
`page`	Event record	Page view data sent as an event record to the HTTP Events source
`track`	Event record	Event name and properties forwarded as event records
`identify`	Event record	Identity and trait data sent as event records for warehouse materialisation

Hightouch processes events through your configured syncs. Data flows from the HTTP Events source into your data warehouse, where Hightouch syncs can pick it up and route it to downstream destinations.

Delivery

Events are delivered server-side from your Datafly Signal infrastructure directly to the Hightouch Events API. No client-side scripts are loaded for this integration.

Testing

After installing the integration, trigger a test event from your website or via the Signal event API.
In Hightouch, navigate to Sources and select your HTTP Events source. Check the event log to verify events are being received.
If you have syncs configured, check the sync run history to verify events are flowing to downstream destinations.
In Signal, check the Live Events view to confirm the event was delivered with a 200 response status.

Troubleshooting

Symptom	Possible Cause	Resolution
`401 Unauthorized`	Invalid API key	Regenerate the API key in Hightouch Settings > API Keys and update the integration config
`404 Not Found`	Incorrect workspace or source ID	Verify the workspace ID and source ID in the Hightouch dashboard
Events received but not syncing	No sync configured	Create a sync in Hightouch that reads from your HTTP Events source and routes to a destination
`429 Too Many Requests`	Rate limit exceeded	Hightouch applies rate limits per API key. Contact Hightouch support to increase limits if needed

Visit Hightouch documentation for full API reference and sync configuration details.

Eulerian HubSpot