> ## Documentation Index
> Fetch the complete documentation index at: https://nango-wari-add-support-for-humaans.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-wari-add-support-for-humaans/AJsG_sqVKX_PY1N9/api-integrations/rootly/organizations.png?fit=max&auto=format&n=AJsG_sqVKX_PY1N9&q=85&s=fba86bbd7048213106b40ca2a908045e" 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-wari-add-support-for-humaans/AJsG_sqVKX_PY1N9/api-integrations/rootly/generate_api_key.png?fit=max&auto=format&n=AJsG_sqVKX_PY1N9&q=85&s=632d086bf4b98bc55da863ccdd0e2d06" 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-wari-add-support-for-humaans/AJsG_sqVKX_PY1N9/api-integrations/rootly/scopes.png?fit=max&auto=format&n=AJsG_sqVKX_PY1N9&q=85&s=f13a9ec20d4f25a28f17b29b5a6d1015" 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-wari-add-support-for-humaans/AJsG_sqVKX_PY1N9/api-integrations/rootly/create_api_key.png?fit=max&auto=format&n=AJsG_sqVKX_PY1N9&q=85&s=8ebee9fd800d6952a7aa5b919ac41501" 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-wari-add-support-for-humaans/AJsG_sqVKX_PY1N9/api-integrations/rootly/api_key.png?fit=max&auto=format&n=AJsG_sqVKX_PY1N9&q=85&s=2d12d0c6cfff41de6a07b394624efa81" 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-wari-add-support-for-humaans/AJsG_sqVKX_PY1N9/api-integrations/rootly/form.png?fit=max&auto=format&n=AJsG_sqVKX_PY1N9&q=85&s=07c94f4eb1e656c972a320fb6957ce2e" style={{maxWidth: "450px" }} width="998" height="1398" data-path="api-integrations/rootly/form.png" />

You are now connected to Rootly.
