> ## 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.

# Incident.io

## Overview

> [card] [Pre-built tooling](#pre-built-tooling)

> [card] [Pre-built integrations](#pre-built-integrations)

> [card] [Access requirements](#access-requirements)

> [card] [Setup guide](#setup-guide)

> [card] [Useful links](#useful-links)

> [card] [API gotchas](#api-gotchas)

## Pre-built tooling

> [accordion] ✅ Authorization
>
> | Tools | Status |
> | - | - |
> | Pre-built authorization (API Key) | ✅ |
> | Pre-built authorization UI | ✅ |
> | Custom authorization UI | ✅ |
> | End-user authorization guide | ✅ |
> | Expired credentials detection | ✅ |

> [accordion] ✅ Read & write data
>
> | Tools | Status |
> | - | - |
> | Pre-built integrations | ✅ |
> | API unification | ✅ |
> | 2-way sync | ✅ |
> | Webhooks from Nango on data modifications | ✅ |
> | Real-time webhooks from 3rd-party API | 🚫 (time to contribute: \<48h) |
> | Proxy requests | ✅ |

> [accordion] ✅ Observability & data quality
>
> | Tools | Status |
> | - | - |
> | HTTP request logging | ✅ |
> | End-to-end type safety | ✅ |
> | Data runtime validation | ✅ |
> | OpenTelemetry export | ✅ |
> | Slack alerts on errors | ✅ |
> | Integration status API | ✅ |

> [accordion] ✅ Customization
>
> | Tools | Status |
> | - | - |
> | Create or customize use-cases | ✅ |
> | Pre-configured pagination | 🚫 (time to contribute: \<48h) |
> | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
> | Per-customer configurations | ✅ |

### Others

| Function name | Description | Type |
| - | - | - |
| `add-alert-tags` | Add alert tags in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `connect-follow-up-external-issue` | Connect a follow-up to an external issue in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-action` | Create action in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-follow-up` | Create follow up in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-incident-alert` | Create incident alert in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-incident-timeline-item` | Create incident timeline item in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-incident-update` | Create incident update in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-incident` | Create incident in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-action` | Delete action in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-follow-up` | Delete follow up in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-action` | Get action in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-alert` | Get alert in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-catalog-entry` | Get catalog entry in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-catalog-type` | Get catalog type in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-follow-up` | Get follow up in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-incident-role` | Get incident role in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-incident-status` | Get incident status in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-incident-timestamp` | Get incident timestamp in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-incident-type` | Get incident type in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-incident` | Get incident in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-postmortem-document-content` | Get postmortem document content in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-postmortem-document` | Get postmortem document in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-schedule-override` | Get schedule override in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-schedule-replica` | Get schedule replica in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-schedule-sync-rule` | Get schedule sync rule in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-schedule` | Get schedule in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-severity` | Get severity in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-team` | Get team in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user-paging-provider` | Get a user paging provider in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user` | Get user in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-actions` | List actions in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-alert-tags` | List alert tags in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-alerts` | List alerts in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-catalog-entries` | List catalog entries in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-catalog-resources` | List catalog resources in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-catalog-types` | List catalog types in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-follow-ups` | List follow ups in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-alerts` | List incident alerts in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-participant-workloads` | List incident participant workloads in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-participants` | List incident participants in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-roles` | List incident roles in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-statuses` | List incident statuses in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-timeline-items` | List incident timeline items in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-timestamps` | List incident timestamps in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-types` | List incident types in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-updates` | List incident updates in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incidents` | List incidents in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-postmortem-documents` | List postmortem documents in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-schedule-entries` | List schedule entries in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-schedule-overrides` | List schedule overrides in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-schedule-replicas` | List schedule replicas in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-schedule-sync-rules` | List schedule sync rules in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-schedules` | List schedules in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-severities` | List severities in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-teams` | List teams in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-user-notification-methods` | List user notification methods in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-user-notification-rules` | List user notification rules in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-users` | List users in incident.io. Returns one page; pass next\_cursor as after to continue. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `remove-alert-tags` | Remove alert tags in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `resolve-alert` | Resolve alert in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `set-alert-tags` | Set alert tags in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `transition-incident-alert` | Transition incident alert in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-action` | Update action in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-follow-up` | Update follow up in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-incident-timeline-item` | Update incident timeline item in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-incident` | Update incident in incident.io. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |

## Access requirements

| Pre-Requisites | Status | Comment |
| - | - | - |
| Paid dev account | ✅ | Teams tier plan required |
| Paid test account | ❌ | Not required |
| Partnership | ❌ | Not required |
| App review | ❌ | Not required |
| Security audit | ❌ | Not required |

## Setup guide

To get started with the Incident.io integration:

1. Sign up for a Teams tier plan or higher at [Incident.io](https://incident.io)
2. Generate an API key in your [Incident.io settings](https://app.incident.io/settings/api-keys)
3. Use the API key to authenticate with Nango

For detailed connection instructions, see our [connection guide](https://nango.dev/docs/integrations/all/incident-io/connect).

> [!TIP]
>
> Need help getting started? Get help in the [community](https://nango.dev/slack).

> [!NOTE]
>
> Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/incident-io.mdx)

## Useful links

* [Generate an Incident.io API Key](https://app.incident.io/settings/api-keys)
* [Incident.io Authentication](https://api-docs.incident.io/#section/Making-requests/Authentication)
* [Web API docs (their REST API)](https://api-docs.incident.io/tag/Actions-V1)

> [!NOTE]
>
> Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/incident-io.mdx)

## API gotchas

* API keys must be passed in the Authorization header as `Bearer <api_key>`
* API keys can have different scopes - make sure to grant the required permissions when creating the key

> [!NOTE]
>
> Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/incident-io.mdx)

## Going further

> [card] [Connect to Incident.io with an API Key](https://nango.dev/docs/integrations/all/incident-io/connect)
>
> Guide to connect to Incident.io using Connect UI


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