# 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="/files/c64f3d3c1a1a2eb921c46bad4abab400e133795e" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/f82ac3d64652fea1ccb1a4c5bd4fb0491f6d2d0b" 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="/files/05d270e642dfed4301759cb9ad098a82ac46931e" 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](/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/configure-a-format.md)
9. Click on **\[T]**&#x74;o save the settings.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buildings.ability.abb/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/connect-devices-via-webhook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.