How to integrate Hightouch with Knock
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
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.
💡
Note: you can also extend this technique to make other calls to the Knock API from your Hightouch models to sync object data or trigger workflows. Please get in touch if you'd like any additional help.
- 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 1000 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: