# Source: https://infisical.com/docs/documentation/platform/workflow-integrations/slack-integration.md

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

# Slack Integration

> Learn how to setup the Slack integration

This guide will provide step by step instructions on how to configure Slack integration for your Infisical projects.

## Setting up Slack integration in your projects

<Tabs>
  <Tab title="Infisical Cloud">
    ### Create Slack workflow integration

    <Steps>
      <Step title="Navigate to the Workflow Integrations tab in your organization settings">
        In order to use Slack integration in your projects, you will first have to
        configure a Slack workflow integration in your organization.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/org-slack-integration-overview.png" alt="org-slack-overview" />
      </Step>

      <Step title="Install Slack app to workspace">
        Press **Add** and select **Slack** as the platform.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/org-slack-integration-initial-add.png" alt="org-slack-initial-add" />

        Give your Slack integration a descriptive alias. You will use this to select the Slack integration for your project.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/org-slack-integration-add-form.png" alt="org-slack-add-form" />

        Press **Connect Slack**. This opens up the Slack app installation flow. Select the Slack workspace you want to install the custom Slack app to and press **Install Infisical**.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/cloud-org-slack-integration-authenticate.png" alt="org-slack-authenticate" />

        This completes the workflow integration creation flow. The projects in your organization can now use this Slack integration to send real-time updates to your Slack workspace.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/cloud-org-slack-integration-workspace.png" alt="org-slack-workspace" />
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/org-slack-integration-created.png" alt="org-slack-created" />
      </Step>
    </Steps>

    ### Configure project to use Slack workflow integration

    <Steps>
      <Step title="Navigate to the Workflow Integrations tab in the project settings">
        Press **Add** and select **Slack** as the platform.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/project-slack-integration-overview.png" alt="project-slack-overview" />
      </Step>

      <Step title="Select the Slack integration to use for the project">
        Your project will send notifications to the connected Slack workspace of the
        selected Slack integration when the configured events are triggered.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/project-slack-integration-select.png" alt="project-slack-select" />
      </Step>

      <Step title="Configure the Slack notification settings for the project and click Save.">
                <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/project-slack-integration-config.png" alt="project-slack-select" />

        <Info>
          To enable notifications in private Slack channels, you need to invite the Infisical Slack bot to join those channels.
        </Info>

        You now have a working native integration with Slack!
      </Step>
    </Steps>
  </Tab>

  <Tab title="Self-hosted setup">
    ### Configure admin settings

    Note that this step only has to be done once for the entire instance.

    <Steps>
      <Step title="Navigate to the Integrations tab in the Admin settings">
        Before anything else, you need to setup the Slack app to be used by
        your Infisical instance. Because you're self-hosting, you will need to
        create this Slack application as demonstrated in the preceding step.

        Click the **Create Slack app** button. This will open up a new window with the
        custom app creation flow on Slack.

                <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/admin-slack-integration-overview.png" alt="admin-settings-slack-overview" />
      </Step>

      <Step title="Create Slack app">
        Select the Slack workspace you want to integrate with Infisical.

                <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/admin-slack-integration-app-workspace-select.png" alt="admin-slack-app-workspace-select" />

        The configuration values of your custom Slack app will be pre-filled for you. You can view or edit the app manifest by clicking **Edit Configurations**.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/admin-slack-integration-app-summary.png" alt="admin-slack-app-summary" />

        Once everything's confirmed, press Create.
      </Step>

      <Step title="Input app credentials from Slack">
        Copy the Client ID and Client Secret values from your newly created custom Slack app and add them to Infisical.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/admin-slack-integration-app-credentials.png" alt="admin-slack-app-credentials" />
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/admin-slack-integration-app-credential-form.png" alt="admin-slack-app-credentials-form" />
        Complete the admin setup by pressing **Save**.
      </Step>
    </Steps>

    ### Create Slack workflow integration

    <Steps>
      <Step title="Navigate to the Workflow Integrations tab in your organization settings">
        In order to use Slack integration in your projects, you will first have to
        configure a Slack workflow integration in your organization.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/org-slack-integration-overview.png" alt="org-slack-overview" />
      </Step>

      <Step title="Install Slack app to workspace">
        Press **Add** and select **Slack** as the platform.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/org-slack-integration-initial-add.png" alt="org-slack-initial-add" />

        Give your Slack integration a descriptive alias. You will use this to select the Slack integration for your project.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/org-slack-integration-add-form.png" alt="org-slack-add-form" />

        Press **Connect Slack**. This opens up the Slack app installation flow. Select the Slack workspace you want to install the custom Slack app to and press **Install Infisical**.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/org-slack-integration-authenticate.png" alt="org-slack-authenticate" />

        Your Slack bot will then be added to your selected Slack workspace. This completes the workflow integration creation flow. Your projects in the organization can now use this Slack integration to send real-time updates to your Slack workspace.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/org-slack-integration-workspace.png" alt="org-slack-workspace" />
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/org-slack-integration-created.png" alt="org-slack-created" />
      </Step>
    </Steps>

    ### Configure project to use Slack workflow integration

    <Steps>
      <Step title="Navigate to the Workflow Integrations tab in the project settings">
        Press **Add** and select **Slack** as the platform.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/project-slack-integration-overview.png" alt="project-slack-overview" />
      </Step>

      <Step title="Select the Slack integration to use for the project">
        Your project will send notifications to the connected Slack workspace of the
        selected Slack integration when the configured events are triggered.
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/project-slack-integration-select.png" alt="project-slack-select" />
      </Step>

      <Step title="Configure the Slack notification settings for the project and click Save.">
                <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/project-slack-integration-config.png" alt="project-slack-select" />

        <Info>
          To enable notifications in private Slack channels, you need to invite your Slack bot to join those channels.
        </Info>

        You now have a working native integration with Slack!
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Using the Slack integration in your private channels

<Steps>
  <Step title="In the Apps section on Slack, find the Infisical app and view the app details">
        <img
          src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/private-slack-setup-menu.png"
          alt="private slack setup
    menu"
        />
  </Step>

  <Step title="Select Add this app to a channel">
        <img
          src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/private-slack-setup-add.png"
          alt="private slack setup
    add"
        />
  </Step>

  <Step title="Find the private channel you want to setup notifications for and press Add">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/private-slack-setup-form.png" alt="private slack setup
    form" />
    You can now view the private channels in the Slack channel selection fields!
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/private-slack-setup-channel-field.png" alt="private slack setup
    channels" />
  </Step>
</Steps>

## Slack Events

The Slack integration supports the following events that can be configured for your projects. Each event is triggered when specific actions occur within your Infisical instance.

<Tabs>
  <Tab title="Access Request">
    ### Access Request

    This event is triggered when a user creates a new access approval request for a project. The notification includes details about the requester, the requested permissions, the secret path and environment, and whether the access is temporary or permanent.

    **When it's triggered:**

    * A user submits a new access approval request through the Infisical UI
    * The request requires approval based on configured access approval policies
    * The notification is sent to the configured access request channels

    **Notification includes:**

    * Requester's full name and email
    * Requested permissions (read, write, etc.)
    * Secret path and environment
    * Access type (temporary or permanent)
    * Optional user note
    * Direct link to review the request

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/access-request-notification.png" alt="access request notification" />

    ### Access Request Updated

    This event is triggered when an existing access approval request is modified or updated. This helps approvers stay informed about changes to pending requests.

    **When it's triggered:**

    * An access approval request is edited by the requester or another authorized user
    * Changes are made to permissions, temporary range, or notes
    * The notification is sent to the configured access request channels

    **Notification includes:**

    * Original requester's information
    * Editor's full name and email (who made the update)
    * Updated permissions
    * Updated secret path and environment
    * Editor's note explaining the changes
    * Direct link to review the updated request

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/access-request-updated-notification.png" alt="access request updated notification" />
  </Tab>

  <Tab title="Secret Approval">
    ### Secret Approval

    This event is triggered when a secret approval request is created. This occurs when a user attempts to create, update, or delete secrets that require approval based on secret approval policies.

    **When it's triggered:**

    * A user creates, updates, or deletes secrets in a path protected by a secret approval policy
    * The changes require approval before being applied
    * The notification is sent to the configured secret request channels

    **Notification includes:**

    * User's email who initiated the change
    * Environment and secret path
    * List of secret keys affected
    * Direct link to review and approve the secret changes

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/secret-approval-notification.png" alt="secret approval notification" />
  </Tab>

  <Tab title="Secret Sync Error">
    ### Secret Sync Error

    This event is triggered when a secret sync operation fails. Secret syncs allow you to synchronize secrets between Infisical and external systems like GitHub, GitLab, AWS Secrets Manager, and others.

    **When it's triggered:**

    * A secret sync fails to push secrets to the destination
    * A secret sync fails to pull secrets from the source
    * A secret sync fails to import secrets
    * A secret sync fails to remove secrets
    * Any other error occurs during the sync process

    **Notification includes:**

    * Sync name and destination
    * The action that failed
    * Environment and secret path
    * Project name
    * Detailed error message explaining the failure
    * Direct link to view and troubleshoot the sync configuration

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/workflow-integrations/slack-integration/secret-sync-error-notification.png" alt="secret sync error notification" />
  </Tab>
</Tabs>