Integrations
Sources
Hightouch
How to integrate Hightouch with Knock
Learn how to power your Knock product notifications using synced data from your data warehouse using Hightouch.
Getting started#
Knock integrates with Hightouch as a downstream destination to sync customer and event data from your data warehouse.
Use cases#
You can use our Hightouch integration to:
- Sync customer data into Knock from your data warehouse (identify)
- Trigger workflows from records added, changed, or removed in your data warehouse
- Populate Audiences with data from your data warehouse. Audiences can be used to trigger workflows or power conditional logic during workflow execution.
Syncing customer data into Knock from Hightouch#
You can use the HTTP request destination within Hightouch to sync your customer data from your data warehouse into Knock.
For this example, we're going to make a call to the Knock API users identify endpoint.
- Create a new HTTP request destination and select your model to query from
- Set an
Authorization
header, with the value set toBearer <your Knock secret API key>
. You can find your secret API key in your dashboard under Developers > API keys - Name your destination "Knock API"
- Create a new sync with your Knock API destination
- Select the types of events that should trigger, the most common case here is "Rows added"
- Set the HTTP request method to
PUT
and the URL tohttps://api.knock.app/v1/users/{{ row.user_id }}
where{{ row.user_id }}
corresponds to the user identifier in the table - Select a "JSON" payload and "Use the JSON editor" to craft the request
- Add at least a
name
,email
, orphone_number
field from your users table - For the rate limit, you can specify 60 requests per second
- You'll likely want to "backfill" all of the available rows meaning that any existing data will also be synced to Knock
- Click "Continue"
- Select your sync frequency
- Click "Finish"
An example configuration for your sync may look something like this: