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

# Managing Integrations

> Create and manage integrations that connect Validio to external services used by notification channels.

Integrations store the connection details and credentials that Validio uses to reach external services such as Slack, Microsoft Teams, Jira, ServiceNow, email servers, and custom webhooks. Each [notification channel](https://docs.validio.io/v10.0/docs/integrations/notification-channels.md) references an integration to know where and how to send alerts, so you configure an external service once as an integration and then reuse it across many channels.

![The Integrations page listing configured integrations with the details sidebar open](https://mintcdn.com/validio/30m58lWK6Ph-vklQ/images/docs/access-and-settings/900-integrations-page.png?fit=max\&auto=format\&n=30m58lWK6Ph-vklQ\&q=85\&s=f2db60e6b5e98e8356212548ad3a97f0)

Integrations page with sidebar

## Integrations and notification channels

An **integration** represents the connection to an external service account (for example, a Slack workspace, a Jira instance, or an SMTP server). A **notification channel** references an integration and adds the destination details for that service, such as a specific Slack channel ID, a Jira project key, or recipient email addresses.

This separation lets you:

* Manage credentials and authentication in one place per external service.
* Create many channels from a single integration, for example, routing different incident types to different Slack channels that all share one Slack app.
* Rotate a credential once and have every dependent channel continue to work.

For the list of supported integration types and their channel configurations, see [Notification Channels](https://docs.validio.io/v10.0/docs/integrations/notification-channels.md).

## Supported integration types

| Integration Type | Use Case |
| :- | :- |
| Slack | Post alerts to Slack channels. See [Slack](https://docs.validio.io/v10.0/docs/integrations/notification-channels/slack.md). |
| Microsoft Teams | Post alerts to Teams channels. See [Microsoft Teams](https://docs.validio.io/v10.0/docs/integrations/notification-channels/microsoft-teams.md). |
| Email | Send rich HTML email notifications. See [Email](https://docs.validio.io/v10.0/docs/integrations/notification-channels/email.md). |
| Jira | Create and sync Jira issues. See [Jira](https://docs.validio.io/v10.0/docs/integrations/notification-channels/jira.md). |
| ServiceNow | Create and bidirectionally sync ServiceNow incidents. See [ServiceNow](https://docs.validio.io/v10.0/docs/integrations/notification-channels/servicenow.md). |
| Webhook | Send JSON payloads to any HTTP endpoint. See [Webhooks](https://docs.validio.io/v10.0/docs/integrations/notification-channels/webhooks.md). |

## Create an integration

![The new integration dialog with the integration type list](https://mintcdn.com/validio/30m58lWK6Ph-vklQ/images/docs/access-and-settings/900-integrations-type.png?fit=max\&auto=format\&n=30m58lWK6Ph-vklQ\&q=85\&s=008b871583dd04b2cf6f9f83e4bb5cbe)

Integration type selection

To add a new integration:

1. Navigate to **Workspace > Integrations** and click **+ New integration**.
2. From the **Integration type** list, select the external service you want to connect (for example, Slack).
3. Enter a **Name** that describes the integration. You will see this name when creating channels, so choose something recognizable (for example, "Production Slack" or "Security Jira").
4. Complete the type-specific configuration fields. Refer to the individual integration page for field descriptions and prerequisites.
5. (Optional) Click **Test integration** to verify the connection. Validio uses the integration's credentials to attempt a round trip to the external service.
6. Click **Create integration**.

> [!NOTE]
>
> Most integration types require prior setup in the external service, such as creating an app in Slack or Microsoft Teams, or provisioning a service account in Jira or ServiceNow. Each channel page lists the prerequisites for its integration type.

## Update an integration

To change an integration's configuration or rotate credentials:

1. Navigate to **Workspace > Integrations**.
2. Click the ⋮ menu for the relevant integration and select **Edit**, or open the integration's sidebar and click **Edit**.
3. Update the fields you want to change. You can retype a secret value to rotate it, or leave secret fields unchanged to keep the current value.
4. (Optional) Click **Test integration** to verify the updated configuration.
5. Click **Update integration**.

Channels that reference the integration continue to route alerts using the updated configuration immediately after the update.

## Delete an integration

Deleting an integration removes it from the workspace and the channels that depend on it stop delivering notifications until they are reassigned to another integration.

To delete an integration:

1. Navigate to **Workspace > Integrations**.
2. Click the ⋮ menu for the relevant integration and select **Delete**.
3. In the confirmation dialog, review any channels that reference this integration, then click **Confirm**.

> [!WARNING]
>
> Before deleting an integration, reassign its channels to another integration of the same type or delete the channels. Notification rules attached to channels will not deliver alerts if their channel's integration is missing.

## Permissions

Integrations are a workspace-wide resource. Users need the **Integrations** read permission to view the integrations list and the **Integrations** write permission to create, update, or delete integrations. For more information, see [Managing Roles](https://docs.validio.io/v10.0/docs/access-and-settings/settings/managing-roles.md) and [About Validio RBAC](https://docs.validio.io/v10.0/docs/access-and-settings/about-validio-rbac.md).