> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-get-deployments-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Rootly - How do I link my account?

# Overview

To authenticate with Rootly, you need:

1. **API Key** - A key that grants secure access to the API, enabling authorized applications to interact with Rootly resources and services.

This guide will walk you through generating your **API Key** within Rootly.

### Prerequisites:

* You must have an account with Rootly.

### Instructions:

#### Step 1: Generating Your API Key

1. Log in to your [Rootly](https://rootly.com/users/sign_in) account.
2. Navigate to the **Organization dropdown** and select **Organization Settings**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/z-j7z5TZWW1x6Vpo/api-integrations/rootly/organizations.png?fit=max&auto=format&n=z-j7z5TZWW1x6Vpo&q=85&s=d50b63ddf2ef34109c3fca43f55f0d9c" width="2680" height="662" data-path="api-integrations/rootly/organizations.png" />

3. Go to the **API Keys** section and click **Generate New API Key**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/z-j7z5TZWW1x6Vpo/api-integrations/rootly/generate_api_key.png?fit=max&auto=format&n=z-j7z5TZWW1x6Vpo&q=85&s=a13a619f406ce820310ee1a483004a4c" width="3024" height="662" data-path="api-integrations/rootly/generate_api_key.png" />

4. Choose the appropriate scope based on your needs. You can refer to the [scope table](https://docs.rootly.com/api-reference/overview#how-to-generate-an-api-key%3F) to determine the right one.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/z-j7z5TZWW1x6Vpo/api-integrations/rootly/scopes.png?fit=max&auto=format&n=z-j7z5TZWW1x6Vpo&q=85&s=b49d4543da951f9041c15fa6af58bd9f" width="1156" height="722" data-path="api-integrations/rootly/scopes.png" />

5. Fill in the form that will pop up with the appropriate information:

* **Name** - A label to help you identify the purpose of this API key (e.g., **Nango Integration**).
* **Description** - A brief summary of what the key will be used for.
* **Expiration** - The duration for which the key should remain active.
* **Incident Response Role** - If creating a **Global API Key**, you must select an appropriate incident response role.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/z-j7z5TZWW1x6Vpo/api-integrations/rootly/create_api_key.png?fit=max&auto=format&n=z-j7z5TZWW1x6Vpo&q=85&s=34eaecf6a1cbee82d0ef3522cdc2a002" width="1156" height="884" data-path="api-integrations/rootly/create_api_key.png" />

6. Click **Create**, and your **API Key** will be generated.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/z-j7z5TZWW1x6Vpo/api-integrations/rootly/api_key.png?fit=max&auto=format&n=z-j7z5TZWW1x6Vpo&q=85&s=0cee49f59f9ace1f30f9d9d1d2bf6749" width="1156" height="596" data-path="api-integrations/rootly/api_key.png" />

#### Step 2: Enter credentials in the Connect UI

Once you have your **API Key**:

1. Open the form where you need to authenticate with Rootly.
2. Enter your **API Key** in its designated field.
3. Submit the form, and you should be successfully authenticated.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/z-j7z5TZWW1x6Vpo/api-integrations/rootly/form.png?fit=max&auto=format&n=z-j7z5TZWW1x6Vpo&q=85&s=eed75528092676e61c9cb9205412893a" style={{maxWidth: "450px" }} width="998" height="1398" data-path="api-integrations/rootly/form.png" />

You are now connected to Rootly.
