# Add a new Integration

### In the [**`Integrations`**](/streamly/concepts/integration.md) section of the app home, click the appropriate :link:`Connect to...` button for the tool you wish to establish an Integration with. 

{% hint style="warning" %}
Before proceeding, it is critical to understand the following concepts:

* [**What is an Integration?**](/streamly/concepts/integration.md)
* [**What is a service user?**](/streamly/concepts/service-user.md)
  {% endhint %}

{% hint style="danger" %}
Failing to configure an **Integration** with a **service user** can cause issues affecting [**Streams**](/streamly/concepts/stream.md) that are connected to the integrated tool in the future.
{% endhint %}

#### Once you understand the reasons that a service user is strongly recommended, click the :ballot\_box\_with\_check:`I understand` button to proceed.  

{% hint style="warning" %}
Ensure you are logged into the chosen tool as the **correct user**, ideally a **service user**, before proceeding with the next step.
{% endhint %}

#### On the next modal, click the :link:`Connect to...` button to establish an Integration between Streamly and the chosen tool.  You will be prompted to complete the authorization in your browser.


---

# 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://happybara.gitbook.io/streamly/reference/integrations/add.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.