# Connect devices via webhook

## Procedure

In a connection via webhook, Eliona acts as the server. A client, e.g. a gateway to which devices are connected, transmits information to Eliona via HTTP.

To do this, an endpoint is created in Eliona. The client sends data to this endpoint.

## Overview

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/mTRsoVOCvA8rHBo1DJ8u/Docs_Verbindungen%20-%20Verbindungen%20Webhook.png" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/nORf2YgrNs35M3JiGUYq/Docs_Verbindungen%20-%20Verbindungen%20Webhook%201.png" alt=""><figcaption></figcaption></figure></div>

<table><thead><tr><th width="100.33333333333331">Icon</th><th width="212">Description</th><th>Details</th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Menu "Connections"</td><td>Click to open the "Connections" menu</td></tr><tr><td><strong>[B]</strong></td><td>Tab</td><td>Access to the respective interfaces</td></tr><tr><td><strong>[C]</strong></td><td>Workspace</td><td>Shows a list of the existing endpoints (if any)</td></tr><tr><td><strong>[D]</strong></td><td>Endpoint</td><td>Existing endpoints</td></tr><tr><td><strong>[E]</strong></td><td>Pause/resume connection</td><td>Click to pause or restart a connection</td></tr><tr><td><strong>[F]</strong></td><td>Connection status</td><td>Shows the current status of the connection</td></tr><tr><td><strong>[G]</strong></td><td>Name</td><td>Name of the endpoint</td></tr><tr><td><strong>[H]</strong></td><td>Path</td><td>The path to which the information is sent</td></tr><tr><td><strong>[I]</strong></td><td>Protection</td><td>Shows the protection status of the respective endpoint</td></tr><tr><td><strong>[J]</strong></td><td>format</td><td>Shows the format that is applied to the selected data</td></tr><tr><td><strong>[K]</strong></td><td>Copy</td><td>Click to duplicate the endpoint</td></tr><tr><td><strong>[L]</strong></td><td>Add new endpoint</td><td>Click to add a new endpoint. Opens the ↗ endpoint details</td></tr><tr><td><strong>[M]</strong></td><td>Delete endpoint</td><td>Deletes the respective endpoint. ⚠ Note: If the connection is also used in other projects, it will also be deleted there.</td></tr><tr><td><strong>[N]</strong></td><td>Endpoint details</td><td>Click to edit the details of the respective endpoint.</td></tr></tbody></table>

## Create a new endpoint/Adjust an existing endpoint&#x20;

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/80VQTfTWvZknFt65BA3g/Docs_Verbindungen%20-%20Verbindungen%20Webhook%202.png" alt=""><figcaption><p>Fig. 3 – The "Configure endpoint" menu </p></figcaption></figure></div>

1. Click on **Connections \[A]** \
   ▷ The Connections window opens
2. Click on **Webhook \[B]**
3. Click on **\[L]**&#x74;o create a new endpoint \
   \&#xNAN;**⇄ OR**\
   Click on **\[N]**&#x74;o edit an existing endpoint. \
   ▷ The "Configure endpoint" menu opens.
4. Give the endpoint in **\[O]** a name. Under this name the endpoint will be in **\[G]** displayed.
5. Enter in **\[P]** a path. The client will send information to this path. \
   ♢ The path consists of 2 parts: a non-editable base URL and a part that you can change.
6. Optional: Enter in **\[Q]** an authorization key. If you enter a value here, the corresponding value must be sent by the client in the request. Otherwise, the request will not be accepted. \
   If you do not want to assign an authorization key: Leave the field empty.
7. Select in **\[R]** the format that is applied to the incoming data.
8. Optional: Click on **\[S]**&#x74;o create a [↗ new format](https://docs.buildings.ability.abb/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/configure-a-format)
9. Click on **\[T]**&#x74;o save the settings.