> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Channels

> List the WhatsApp, Instagram, Telegram, Messenger and Email channels connected to your organization.

# Channels

Returns the organization's connected channels (WhatsApp, Instagram, Telegram, Facebook Messenger and Email), from newest to oldest. Access tokens aren't exposed — only safe identification data. The web widget isn't included in this list: it isn't a connected channel.

```http theme={null}
GET https://app.chatnorris.ai/api/v2/channels
Authorization: Bearer <your_api_key>
```

**Required scope:** `channels:read`

***

## Response

```json theme={null}
{
  "status": "success",
  "data": {
    "channels": [
      {
        "id": "ch_abc123",
        "type": "whatsapp",
        "status": "active",
        "chatbot_id": "bot_xyz789",
        "config_display": {
          "display_phone_number": "+54 9 11 1234-5678",
          "verified_name": "Acme Corp"
        },
        "created_at": "2025-05-10T12:00:00.000Z"
      },
      {
        "id": "ch_def456",
        "type": "instagram",
        "status": "active",
        "chatbot_id": "bot_xyz789",
        "config_display": {
          "ig_username": "acmecorp",
          "page_name": "Acme Corp Official"
        },
        "created_at": "2025-08-20T09:00:00.000Z"
      },
      {
        "id": "ch_ghi789",
        "type": "telegram",
        "status": "active",
        "chatbot_id": "bot_xyz789",
        "config_display": {
          "bot_username": "acmecorp_bot",
          "bot_name": "Acme Corp"
        },
        "created_at": "2026-07-15T09:00:00.000Z"
      },
      {
        "id": "ch_jkl012",
        "type": "email",
        "status": "active",
        "chatbot_id": "bot_xyz789",
        "config_display": {
          "mailbox_address": "soporte@acme.com",
          "inbound_address": "a1b2c3d4e5@inbound.chatnorris.ai",
          "signature_text": "Acme support team"
        },
        "created_at": "2026-09-01T09:00:00.000Z"
      }
    ]
  }
}
```

### Response fields

| Field | Type | Description |
| - | - | - |
| `id` | string | Unique ID of the channel |
| `type` | string | Type: `whatsapp`, `instagram`, `telegram`, `messenger` or `email` |
| `status` | string | Status: `active` or `inactive` |
| `chatbot_id` | string | ID of the agent assigned to the channel |
| `config_display` | object | Public channel data (no tokens). Fields without a value are omitted |
| `config_display.display_phone_number` | string | Phone number (WhatsApp only) |
| `config_display.verified_name` | string | Verified name in Meta (WhatsApp only) |
| `config_display.ig_username` | string | Instagram username (Instagram only) |
| `config_display.page_name` | string | Facebook page name (Messenger, and Instagram channels connected with a Facebook page) |
| `config_display.bot_username` | string | Telegram bot username (Telegram only) |
| `config_display.bot_name` | string | Telegram bot name (Telegram only) |
| `config_display.mailbox_address` | string | Mailbox the agent handles; replies carry this address as Reply-To (Email only) |
| `config_display.inbound_address` | string | ChatNorris inbound address you forward the mailbox's emails to (Email only). Treat it as private data |
| `config_display.signature_text` | string | Signature text added to replies (Email only) |
| `config_display.signature_logo_url` | string | Signature logo URL (Email only) |
| `created_at` | string | Connection date (ISO 8601) |

> [!NOTE]
>
> Available channels depend on the plan: Telegram on all plans, WhatsApp, Instagram and Messenger from Standard, and Email on Premium only (see [Connect messaging channels](https://docs.chatnorris.ai/en/guias/canales-whatsapp-instagram.md)).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.