Go to the Destinations overview page and click the Add destination button. Select Airship and click Continue.
You can then authenticate Hightouch to Airship using either basic authentication or bearer authentication.
For both types, you need to enter your Airship Cloud Site. See Airship's docs for more info.
Then, for basic authentication, enter these fields:
App Key: This is an Airship-generated string identifying your application. You can find it in your Airship dashboard.
Master Secret: Airship-generated string used for server-to-server API access. You can find it in your Airship dashboard.
Follow the instructions in this article
to retrieve your App Key and Master Secret
For bearer authentication:
Access Token: This is an access token used to grant control permissions to the Airship API.
Follow the instructions in this article to retrieve your Access token.
Once you've set up your Airship destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Airship destination you want to sync to.
Although predefined
attributes
are avaliable in the dropdown by default, you must first define them in Airship
for them to be valid. Airship skips invalid attributes by default.
Hightouch allows you to sync values to existing tag groups in Airship. Enter the Group key in the right side of the tags mappings section to map values to an existing tag group.
See Airship's docs for more information on tag groups.
You can map string or array values to tags.
If you provide a string, Hightouch automatically transforms it into an array using commas as the delimiters for different elements.
For example, Hightouch transforms the string "dogs, cats, parrots" into this array: ["dogs, "cats", "parrots"].
You can map data from any of your model columns to fields in Airship. Airship requires the Scopes field, so you must map it to complete your configuration. Refer to Airship's scopes docs to see valid values.
Ensure the data types of your model columns match the data types of the fields you want to sync to.
To date, our customers haven't experienced any errors while using this destination. If you run into any issues, please don't hesitate to . We're here to help.
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.