---
title: "List Discord channels"
method: GET
path: "/v2/integrations/oauth2/discord/channels"
tags: ["accounts"]
---

# List Discord channels

`GET /v2/integrations/oauth2/discord/channels`

## Request

- Base URL: `https://backend.blotato.com`
- URL: `https://backend.blotato.com/v2/integrations/oauth2/discord/channels`
- Auth: API key in header `blotato-api-key`

Lists the text, announcement and forum channels of the connected Discord server that the Blotato bot can view, so the user can choose which to add as posting targets. A channel that is missing appears after the Blotato bot is allowed to view it in Discord.

## Query parameters

- `accountId` string, required

## Response `200`

Default Response

- object
  - `items` object[], required
    - `id` string, required: Discord channel id.
    - `name` string, required: Channel name, without the leading #.
    - `kind` 'text' | 'announcement' | 'forum', required: Kind of channel. A post to a forum channel opens a new forum post and needs target.title.
    - `isActive` boolean, required: Whether Blotato is already connected to this channel.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `422`: Default Response
- `429`: Rate limit exceeded
- `500`: Server error

## Changes

- **2026-11-19** `5daff2f14245`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/blotato/apis/blotato-api/changes/v2/integrations/oauth2/discord/channels/get.md)

---

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