> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/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/ExGQYMKU-fJbbeP8/api-integrations/rootly/organizations.png?fit=max&auto=format&n=ExGQYMKU-fJbbeP8&q=85&s=b93d28553e0cc95026a66f124a534f3e" 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/ExGQYMKU-fJbbeP8/api-integrations/rootly/generate_api_key.png?fit=max&auto=format&n=ExGQYMKU-fJbbeP8&q=85&s=f91d9f1902e635b5bee38253056660d5" 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/ExGQYMKU-fJbbeP8/api-integrations/rootly/scopes.png?fit=max&auto=format&n=ExGQYMKU-fJbbeP8&q=85&s=70c6f7b731532c694e50365161bb4650" 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/ExGQYMKU-fJbbeP8/api-integrations/rootly/create_api_key.png?fit=max&auto=format&n=ExGQYMKU-fJbbeP8&q=85&s=3d2ebd370b3c04389cce474ee13d1524" 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/ExGQYMKU-fJbbeP8/api-integrations/rootly/api_key.png?fit=max&auto=format&n=ExGQYMKU-fJbbeP8&q=85&s=c77f53766ff0e9d0b82a8133a905da76" 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/ExGQYMKU-fJbbeP8/api-integrations/rootly/form.png?fit=max&auto=format&n=ExGQYMKU-fJbbeP8&q=85&s=a11b825478f0d049399bc0e42962337e" style={{maxWidth: "450px" }} width="998" height="1398" data-path="api-integrations/rootly/form.png" />

You are now connected to Rootly.
