---
title: "Get the Slack integration configuration"
method: GET
path: "/integrations/{owner}/configuration/slack"
tags: ["integrations"]
---

# Get the Slack integration configuration

`GET /integrations/{owner}/configuration/slack`

## Request

- Base URL: `https://api.mergify.com/v1`
- URL: `https://api.mergify.com/v1/integrations/{owner}/configuration/slack`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

List the Slack channels connected to the organization, with the notification configurations of every product. A channel is connected from the Mergify dashboard; this API cannot connect one.

## Path parameters

- `owner` string, required: The owner of the repository

## Response `200`

Successful Response

- SlackConfigurationResponse
  - `channels` SlackNotificationChannelConfiguration[], required: The Slack channels connected to the organization
    - `id` string, uuid, required: The ID of the Slack channel configuration
    - `slack_channel` string, required: The Slack channel the notifications are posted to
    - `slack_team_name` string, nullable, required: The name of the Slack workspace the channel belongs to
    - `disabled_at` string, date-time, nullable, required: When Mergify stopped being able to post to this channel. Null while the channel receives notifications.
    - `disabled_reason` 'webhook_gone' | 'oauth_revoked', nullable, required: Why Mergify cannot post to this channel anymore. Null while the channel receives notifications.
    - `merge_queue_configs` MergeQueueNotificationConfiguration[], required: The `merge_queue_notification` configurations of the channel
      - `id` string, uuid, required: The ID of the notification configuration
      - `repositories` SlackNotificationRepository[], required: The repositories this configuration notifies about. Empty means every repository of the organization.
        - `id` integer, required: The ID of the repository
        - `owner` GitHubAccount, required
          - `login` string, required
          - `id` integer, required
          - `type` 'User' | 'Organization' | 'Bot' | 'Mannequin' | 'Enterprise', nullable, required
          - `avatar_url` string, nullable
        - `name` string, required: The name of the repository
        - `full_name` string, required: The full name of the repository, `owner/name`
      - `events` MergeQueueNotificationEvent[], required: The merge queue events posted to the channel, each with the outcomes it posts. Empty means every event.
        - `type` 'action.assign' | 'action.backport' | 'action.close' | 'action.comment' | 'action.copy' | 'action.delete_head_branch' | 'action.dequeue' | 'action.dismiss_reviews' | 'action.edit' | 'action.github_actions' | 'action.label' | 'action.label.loop_stopped' | 'action.merge' | 'action.post_check' | 'action.queue.batch_bisection_end' | 'action.queue.batch_bisection_start' | 'action.queue.batch_composition' | 'action.queue.change' | 'action.queue.checks.change' | 'action.queue.checks_end' | 'action.queue.checks_postponed' | 'action.queue.checks_start' | 'action.queue.conflict_deferred' | 'action.queue.enter' | 'action.queue.leave' | 'action.queue.merged' | 'action.rebase' | 'action.refresh' | 'action.request_reviews' | 'action.review' | 'action.squash' | 'action.update' | 'ci_insights.auto_quarantine.disabled' | 'ci_insights.auto_quarantine.enabled' | 'ci_insights.auto_quarantine.modified' | 'ci_insights.job_retried' | 'command.dequeue' | 'command.queue' | 'pipeline.create' | 'pipeline.delete' | 'pipeline.update' | 'product.disabled' | 'product.enabled' | 'queue.pause.create' | 'queue.pause.delete' | 'queue.pause.update' | 'scheduled_freeze.create' | 'scheduled_freeze.delete' | 'scheduled_freeze.update' | 'test.dequarantined' | 'test.health.changed' | 'test.quarantined', required
        - `outcomes` EventOutcome[]: The outcomes of this event to post, among those it can have. A request may leave it empty for every outcome; a response always lists them.
    - `ci_insights_configs` CiInsightsNotificationConfiguration[], required: The `ci_insights_notification` configurations of the channel
      - `id` string, uuid, required: The ID of the notification configuration
      - `repositories` SlackNotificationRepository[], required: The repositories this configuration notifies about. Empty means every repository of the organization.
        - `id` integer, required: The ID of the repository
        - `owner` GitHubAccount, required
          - `login` string, required
          - `id` integer, required
          - `type` 'User' | 'Organization' | 'Bot' | 'Mannequin' | 'Enterprise', nullable, required
          - `avatar_url` string, nullable
        - `name` string, required: The name of the repository
        - `full_name` string, required: The full name of the repository, `owner/name`
      - `branches` string[], required: The branches whose CI jobs are reported. Empty means every branch.
      - `pipeline_names` string[], required: The CI pipelines whose jobs are reported. Empty means every pipeline.
      - `job_names` string[], required: The CI jobs that are reported. Empty means every job.
      - `conclusions` string[], required: The job conclusions that are reported. Empty means every conclusion.
    - `test_quarantine_configs` TestQuarantineNotificationConfiguration[], required: The `test_quarantine_notification` configurations of the channel
      - `id` string, uuid, required: The ID of the notification configuration
      - `repositories` SlackNotificationRepository[], required: The repositories this configuration notifies about. Empty means every repository of the organization.
        - `id` integer, required: The ID of the repository
        - `owner` GitHubAccount, required
          - `login` string, required
          - `id` integer, required
          - `type` 'User' | 'Organization' | 'Bot' | 'Mannequin' | 'Enterprise', nullable, required
          - `avatar_url` string, nullable
        - `name` string, required: The name of the repository
        - `full_name` string, required: The full name of the repository, `owner/name`
      - `event_types` string[], required: The test events posted to the channel. Empty means every event except `test.health.changed`, which is posted only when listed.
      - `health_from_states` HealthStatus[], required: The health states a test leaves for its `test.health.changed` event to be posted. Empty means every state.
      - `health_to_states` HealthStatus[], required: The health states a test enters for its `test.health.changed` event to be posted. Empty means every state.
  - `merge_queue_event_possible_outcomes` object, required: The outcomes each Merge Queue event can have, which a notification can narrow it to.

## Other responses

- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable entity

## Changes

- **2026-10-23** `00b8f4a31190`: 2 info
  - added the required property `channels/items/test_quarantine_configs/items/health_from_states` to the response with the `200` status
  - added the required property `channels/items/test_quarantine_configs/items/health_to_states` to the response with the `200` status
- **2026-10-23** `1ea6ea8c150a`: 1 warning
  - added the new `test.health.changed` enum value to the `channels/items/test_quarantine_configs/items/event_types/items/` response property for the response status `200`
- **2026-10-21** `b46b77eba26e`: 6 warning
  - added the new `pipeline.create` enum value to the `channels/items/merge_queue_configs/items/events/items/type` response property for the response status `200`
  - added the new `pipeline.create` enum value to the `merge_queue_event_possible_outcomes/propertyNames/` response property for the response status `200`
  - added the new `pipeline.delete` enum value to the `channels/items/merge_queue_configs/items/events/items/type` response property for the response status `200`
  - added the new `pipeline.delete` enum value to the `merge_queue_event_possible_outcomes/propertyNames/` response property for the response status `200`
  - …2 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/mergify/apis/mergify-api/changes/integrations/:owner/configuration/slack/get.md)

---

[API](https://skmtc.dev/mergify/apis/mergify-api.md) · [All operations](https://skmtc.dev/mergify/apis/mergify-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mergify/apis/mergify-api/revisions/00b8f4a31190?raw)