> For the complete documentation index, see [llms.txt](https://happybara.gitbook.io/streamly/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://happybara.gitbook.io/streamly/reference/integrations/add.md).

# 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.