Hightouch

Destination/Base URL: To send data to your Xoal account from Hightouch, use the following API endpoint as your destination:

https://api.xoal.io/ingest/v1/hightouch/event

HTTP Method:

POST

Authentication: Use the following key: value pairs in your headers to authenticate requests:

{
  “Authorization” : “Bearer your_ingestion_API_Key”,
  “Content-Type” : “application/json”
}

Pay attention to capitalisation used in the headers.

Get data ingestion key

To obtain your_ingestion_API_Key, click the "Settings" bottom left of your Xoal dashboard, select ‘Webhook & API’. In the API section, click ‘New API key’ in the top right corner. In the box that appears, give the API Key a name, e.g ‘API key for Hightouch ingestion then select ‘Data ingestion’ for the API type and click ‘Create key’ as shown below:

Once the key is created, copy it and use in your header. A typical ingestion key looks like this:

ing_9busllahgyplx8d7vzaxbaut9eox75yu

In SUMMARY, your setup should look like this:

• Destination URL : https://api.xoal.io/ingest/v1/hightouch/event

• HTTP Method : POST

• Headers :

{
 “Authorization” : “Bearer ing_9busllahgyplx8d7vzaxbaut9eox75yu”, 
 “Content-Type” : “application/json”
}

Setting up Hightouch to send data to Xoal

In your Hightouch account, go to Intergrations → Destinations → HTTP Request and click ‘Connect destination’ as shown below:

Next, select ‘Basic Auth’ option:

Enter https://api.xoal.io/ingest/v1/hightouch/event for the Base URL, then add two headers; ‘Authorization’ and ‘Content-Type’, with values of ‘Bearer your_ingestion_API_Key’ and ‘application/json’ respectively, then click ‘Continue’ as shown below:

You will be prompted to give a name to this destination. Click ‘Finish’ to save:

Hurray! Xoal is successfully connected to your Hightouch CDP and can receive requests from it.

In case you have any questions or need help, do not hesitate to contact us on chat support, or write us on [e-mail]