---
title: "Get the Slack workspaces connected to an organization, oldest first, pending and failed connections included. Only the organization owner or a delegated team member with the manageBrands permission may call this; when the plan no longer allows Slack (slack-availability planLocked), the owner still gets them."
method: GET
path: "/v2/organizations/{organizationId}/slack-connections"
tags: ["Organization Slack Connections Api Service"]
---

# Get the Slack workspaces connected to an organization, oldest first, pending and failed connections included. Only the organization owner or a delegated team member with the manageBrands permission may call this; when the plan no longer allows Slack (slack-availability planLocked), the owner still gets them.

`GET /v2/organizations/{organizationId}/slack-connections`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/organizations/{organizationId}/slack-connections`
- Auth: none declared

## Path parameters

- `organizationId` integer, required

## Response `200`

Connections retrieved.

- JsonOkListResponseSlackConnectionDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` SlackConnectionDto[]
    - `id` integer: Id of the connection.
    - `status` 'active' | 'pending' | 'error': State of the connection: active, pending (the user started connecting but never came back from Slack, usually because a workspace admin has to approve the app) or error.
    - `errorCode` 'appUninstalled' | 'tokenRevoked' | 'missingScopes' | 'disconnected' | 'workspacePolicy', nullable: Why the connection is in error. Null unless status is error.
    - `workspace` SlackWorkspaceDto: A Slack workspace.
      - `teamId` string: Id Slack assigns to the workspace (team id).
      - `name` string: Name of the workspace.
    - `createdBy` SlackConnectionCreatorDto, nullable: The user who connected the Slack workspace.
      - `name` string: First name and last name of the user, or their email when they have no first name.
      - `profilePicture` string, nullable: URL of the user's profile picture. Null when they have none, and the front shows their initials instead.
    - `createdAt` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `brandsCount` integer: How many of the organization's brands send their notifications through this connection.

## Other responses

- `403`: Caller is not a regular-user session, or is neither the organization owner nor a team member with manageBrands (a team member also needs the organization to be usable: its permissions feature and the owner's plan).
- `404`: Organization not found, or its owner account could no longer be resolved.

---

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