# Establish a new connection

## Overview

<div data-full-width="true"><figure><img src="/files/6615349627776d21081fbaf934088dc12a09aeec" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/91856ff3518f23893cef30cd739c22f2607a42e3" alt=""><figcaption></figcaption></figure></div>

| Icon     | Description             | Details                                                                                                                           |
| -------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **\[A]** | Menu "Connections"      | Click to open the "Connections" menu                                                                                              |
| **\[B]** | Tab                     | Access to the respective interfaces                                                                                               |
| **\[C]** | Workspace               | Displays a list of existing connections (if any)                                                                                  |
| **\[D]** | Connections             | Existing connections                                                                                                              |
| **\[E]** | Pause/resume connection | Click to pause or restart a connection                                                                                            |
| **\[F]** | Connection status       | Shows the current status of the connection                                                                                        |
| **\[G]** | Name                    | Connection name                                                                                                                   |
| **\[H]** | Client ID               | Displays the client ID                                                                                                            |
| **\[I]** | Consumer group          | Displays the consumer group                                                                                                       |
| **\[J]** | Seeds                   | Displays the seed                                                                                                                 |
| **\[K]** | Create new connection   | Click to create a new connection                                                                                                  |
| **\[L]** | Delete connection       | Deletes the respective connection. ⚠ Warning: If the connection is also used in other projects, it will be deleted there as well. |
| **\[M]** | Connection details      | Click to open the connection details                                                                                              |

## Create a new connection

Proceed as follows to establish a new connection to a broker or to edit an existing connection

1. Click in the sidebar on **Connection \[A]**\
   ▷ The “Connections” window opens
2. Select in the tab **Kafka \[B]** from
3. The workspace displays a list of all existing connections **\[C]** \
   ◈ If you do not see any entries, no connections have been created yet  \
   ◈ Connections created in other projects are also displayed
4. Click on **\[K]**, to create a new connection \
   ▷ The [↗ "Connection details"](/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/connect-devices-via-mqtt/configure-client.md)&#x20;

## Edit connection

1. Click in the sidebar on **Connection \[A]**\
   ▷ The “Connections” window opens
2. Select in the tab **MQTT \[B]** from
3. A list of all brokers already connected is displayed in the workspace **\[C]** \
   ◈ Brokers configured in other projects are also displayed
4. Click on \[**M]**, to open an existing connection \
   ▷ The [↗ "Connection details"](/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/connect-devices-via-mqtt/configure-client.md)&#x20;


---

# 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/...with-kafka/establish-a-new-connection.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.