How to configure Xurrent for integration with ONEiO

Introduction

This document shows an example of what needs to be done in Xurrent to make it integration-ready with the endpoint in your ONEiO. Note also, that the amount of fields used in integrations might vary. 

In case you have questions related to setting up the integration, send a mail to support@oneio.cloud.

You can sign up for a free trial of ONEiO from the following link: ONEiO Free Trial

Sending messages from ONEiO to Xurrent

ONEiO accesses Xurrent by using the Xurrent REST API

Create Integration user to Xurrent

Add integration user to Xurrent. This user is used to create an update the entities that are integrated. Please note that you need to have a user that is dedicated to the integration use. This is due the fact that there is no possibility to filter out the updates that the integration user has done in the outgoing webhooks. This means that you need to set the integration user in inbound whitelisting to avoid the update to Xurrent to be echoed back to ONEiO and not cause looping of messages. 

Sending messages from Xurrent to ONEiO

Xurrent accesses ONEiO with webhooks. To enable the webhook, you need to navigate to the Webhooks section in Settings.

To add a webhook, simply click the "+" button on the top banner.

Give the webhook a name and select the Event it will be triggered from and the URI.

Please note that Xurrent does not provide any means to properly set authentication to the webhook. Because of that, only option is to include them into the URI directly. You can retrieve the whole URI with credentials (URL encoded) from your ONEiO endpoint.