# Connect Slack, Telegram, Discord or email to an agent

`POST /v1/agents/{agent}/channels`

**In this build:** Uses a stand-in for an external service. The record, inbound URL and message delivery are real. Slack, Telegram and Discord need registered bot accounts, which aren't connected.

**Scope:** `platform.write`

**CLI:** `harebox channel connect`

## Request: `ConnectChannelRequest`

| Field | Type | Notes |
|---|---|---|
| `kind` (required) | `string` | One of: `slack`, `telegram`, `discord`, `email` |
| `name` | `string` |  |

## Response: 201

`Channel`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `agent` (required) | `string` |  |
| `kind` (required) | `string` | One of: `slack`, `telegram`, `discord`, `email` |
| `name` | `string` |  |
| `status` (required) | `string` |  |
| `inbound_url` | `string` |  |
| `secret` | `string` | Shown once. The bot relay sends it with each message. |
| `messages` | `integer` |  |
| `created_at` | `string` |  |

Errors follow [one format](../errors.html).