## Introduction

incident.io is an incident response SaaS product that can manage and help coordinate a company's response to an incident. This guide walks you through the steps to gather the necessary information and configure your incident.io account for the purpose of creating an integration with Synqly's Application Security connector.

## Prerequisites

Before you begin, ensure that you have:

- A incident.io account with the Team, Pro, or Enterprise plan
- Access to your accounts incident.io dashboard with a user account that has permission to create and manage API keys. This permission is automatically included in the Owner and Admin base roles


## Required API Key Scopes

| Operation | Required Scopes |
|  --- | --- |
| Query Escalation Policies | `catalog_types.view`  `catalog_entries.view`  `managed_resources.view` |
| Query Escalation Policy Users On Call | `catalog_types.view`  `catalog_entries.view`  `schedules.view`  `managed_resources.view` |


## Generating an API Key

1. Log into your incident.io account's dashboard with a user account that has permission to create and manage API keys
2. Select your account in the upper left hand corner and then select **Settings**
3. Select **API keys** under the *Extend* header
4. Select **Add new**
5. Fill out the Name field and check the boxes next to one or more roles  until each of the required scopes is included. The required scopes can be found in the section above titled [Required API Key Scopes](#required-api-key-scopes)
6. Select **Create**
7. Copy the access token displayed and store it in a safe place
8. You have now created a new incident.io API key, proceed to the next section titled [Configuring the Integration](#configuring-the-integration)


## Configuring the Integration

To configure a new incident.io integration in the Synqly system, provide each of the values as defined below:

| Integration Parameter | Description |
|  --- | --- |
| Secret | This is the API Key value generated from executing the steps above |