Rudderstack

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

https://api.xoal.io/ingest/v1/rudderstack/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 Rudderstack 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/rudderstack/event

• HTTP Method : POST

• Headers :

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

Setting up Rudderstack to send data to Xoal

Login to your Rudderstack dashboard > Directory > Destinations. Then select webhook.

Give the connection a name. Eg. Send data to Xoal. Then click Continue

Rudderstack will ask you to add a source. You can select an existing source, create new one. You can click on continue to continue without adding a source.

Finally add the Webhook settings provided earlier as in the screenshot below. Then click Continue

That’s all! If you have any question, do reach out to use at [email protected]