> ## Documentation Index
> Fetch the complete documentation index at: https://infisical.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# incident.io connection

> Learn how to configure an incident.io connection for Infisical.

An incident.io connection authenticates Infisical to incident.io with an [API key](https://docs.incident.io/admin/api-keys), so Infisical can check who is on call in your incident.io schedules.

> [!NOTE]
>
> This guide only authenticates Infisical with incident.io. Once the app connection is ready, you can [use it to set up integrations](#step-3-configure-integrations).

## Prerequisites

* An incident.io user with the **Manage API keys** and **View on-call resources** permissions (incident.io only lets you give an API key permissions that you have)

## Step 1: Create an API key

Infisical needs an incident.io API key that can read your on-call schedules.

**Step 1**

In incident.io, go to **Settings** > **API keys** and create an API key.

**Step 2**

Enter a name, such as `infisical`, and give the key the **View on-call resources** permission.

**Step 3**

Copy the key. incident.io shows it only once.

## Step 2: Create the app connection

Next, create the app connection in Infisical.

> [!TIP]
>
> To create the connection using the API, use the incident.io [Create](https://infisical.com/docs/api-reference/endpoints/app-connections/incident-io/create.md) endpoint.

**Step 1**

In the sidebar, select **Integrations**, then open the **App Connections** tab.

**Step 2**

Select **Add Connection** and choose **incident.io**.

**Step 3**

Fill out the form's fields:

* **Name**: A descriptive name for the connection
* **Description** (optional): A note for future reference
* **Method**: **API Key**
* **API Key**: The API key you [created in Step 1](#step-1-create-an-api-key)

Then, select **Connect to incident.io**.

When you select **Connect to incident.io**, Infisical checks that the API key can read your schedules, and doesn't save the connection if it can't.

> [!TIP]
>
> Your incident.io app connection is ready to use.

## Step 3: Configure integrations

Now that your incident.io app connection is configured, you can use it to set up the following integrations:

> [card] [PAM auto-approval](https://infisical.com/docs/documentation/platform/pam/access-requests/auto-approval.md)
>
> Approve PAM access requests from users who are on call in incident.io.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.