Xoal
Go to XoalCustomer loginSign up
  • Welcome
  • Getting Started
    • Quick start
  • Messaging
    • Customer Journey Automation
    • Broadcast
  • Data & segmentation
    • Customer data
    • Customer attribute
    • Customer events
    • Customer segmentation
  • Integrations
    • Segment
    • Rudderstack
    • Hightouch
    • Jitsu
  • APIs
    • Customer API
    • Customer Attribute API
    • Company API
    • Field registry API
    • Workflow API
    • Workflow Trigger API
    • Event Ingestion API
Powered by GitBook
On this page
  • Get data ingestion key
  • Setting up Hightouch to send data to Xoal
  1. Integrations

Hightouch

PreviousRudderstackNextJitsu

Last updated 3 months ago

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:

  • 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:

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 support@xoal.io

Destination URL :

Enter 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:

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