---
title: "Get the Slack workspaces the brand's destination can use: the active Slack connections of the brand's organization. Empty when the organization has none (or the brand has no organization)."
method: GET
path: "/v2/settings/brands/{brand-id}/slack-connections"
tags: ["Brand Slack Destinations Api Service"]
---

# Get the Slack workspaces the brand's destination can use: the active Slack connections of the brand's organization. Empty when the organization has none (or the brand has no organization).

`GET /v2/settings/brands/{brand-id}/slack-connections`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/settings/brands/{brand-id}/slack-connections`
- Auth: none declared

## Path parameters

- `brand-id` integer, required

## Response `200`

Connections retrieved.

- JsonOkListResponseSlackAvailableConnectionDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` SlackAvailableConnectionDto[]
    - `id` integer: Id of the organization's connection.
    - `workspace` SlackWorkspaceDto: A Slack workspace.
      - `teamId` string: Id Slack assigns to the workspace (team id).
      - `name` string: Name of the workspace.

## Other responses

- `400`: brand-id does not match the request blogId.
- `403`: Caller is not a regular-user session or lacks editBrand on the brand (a team member with manageBrands in its organization has it).

---

[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/aea9d9a8415a?raw)
