---
title: "List available channels"
method: GET
path: "/integrations/{integration_id}/channels"
tags: ["Integrations", "Integrations"]
---

# List available channels

`GET /integrations/{integration_id}/channels`

List available channels/chats for a connected integration.

Also returns the connection's currently-selected IDs so a picker can
render the right boxes pre-checked without a second round trip.

## Path parameters

- `integration_id` string, required

## Query parameters

- `connection_id` string, required — The connection ID to use for listing channels
- `parent_id` string, nullable — For hierarchical providers (e.g. Microsoft Teams): omit to list root containers (workspaces); pass a container's id to list its children (sub-channels). Selected ids in the response always reflect the leaf values stored in user_options.channels regardless of which level is queried.

## Response `200`

Successful Response

- ListChannelsResponse
  - `channels` ChannelInfo[], required
    - `id` string, required
    - `name` string, required
    - `type` string
  - `selected` string[] — IDs currently in connection.user_options.channels — pre-checked in pickers.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hyperspell/apis/hyperspell-api.md) · [All operations](https://skmtc.net/hyperspell/apis/hyperspell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperspell/hyperspell-api/revisions/5721acd588e6/schema)