---
title: "Create a channel"
method: POST
path: "/inboxes/{inbox_id}/channels"
tags: ["Channels"]
---

# Create a channel

`POST /inboxes/{inbox_id}/channels`

Create a channel in an inbox.

Required scope: `channels:write`

## Path parameters

- `inbox_id` string, required

## Request body

- CreateChannel
  - `name` string — Name of the channel
  - `settings` object — Settings of the channel
    - `undo_send_time` 0 | 5 | 10 | 15 | 30 | 60 — The time (measured in seconds) that users have to undo a send operation in the channel.
    - `all_teammates_can_reply` boolean — Whether teammates without inbox access can reply on this channel. Only allowed for shared channels.
    - `webhook_url` string — The webhook URL outbound messages should be sent to. Only allowed for "custom" type channels.
    - `sid` string — The SID of the Twilio channel. Only allowed for "twilio" type channels.
    - `auth_token` string — The auth token for the Twilio account. Only allowed for "twilio" type channels.
  - `type` 'custom' | 'smtp' | 'twilio', required — Type of the channel
  - `send_as` string — Sending address of your channel. Required for SMTP and Twilio channels.

## Response `204`

No content

---

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