Skip to main content

Hostex

How to authenticate the integration​

We'll use a test app, Acme AI, to show how an end-user can authenticate the integration between Hostex and Acme AI.

  1. Go to Settings > Integrations section within Acme AI app.

  2. Among the list of Integrations, click on Hostex's logo and you will be redirected to the Authentication Screen as shown below.

    hostex auth 1

  3. Now switch over to your Hostex Account in a new tab. Go to 'Workplace > Open API'. Click on 'API'.

    hostex auth 2

  4. Click on ‘+ Add new’. Name your token and Click on ‘Create’. Copy the ‘Access token’ to your clipboard.

  5. Paste it back on your Authentication Screen (from 2nd point) and Click on ‘Connect’. You will see a message box that shows you’ve successfully authenticated the integration. You will be redirected back to Acme app now.

How to set-up Real-time webhooks​

  1. Once you've authenticated the integration, go to your Calry workspace. Go to Accounts > Onboarded Hostex Account > Webhooks. Enter the name and URL where you want to recieve webhook events. Select the events you want to subscribe to and Click on 'Create'. Copy the Listener URL, as highlighted below.

hostex auth 3

  1. Or if you're already using the Create Webhook API to subscribe to webhooks, you can use the listenerUrl from the API response to display it to your end-user within the UI. This listenerUrl will be used in the following steps.

  2. Now switch over to your Hostex account in a new tab. Go to 'Workplace > Open API > Web Hooks'.

    hostex auth 4

  3. Click on ‘+ Add new’ and paste the Listener URL here. You will start recieving webhooks from this account now!

If you have any questions or need help, don't hesitate to reach out at mail@calry.app.