---
title: "Create channel"
method: POST
path: "/corporate/v1/channels"
tags: ["Channels"]
---

# Create channel

`POST /corporate/v1/channels`

Creates a new channel for transaction routing and control

Channels are used to control back business transactions and enable routing based on the source of the transaction.

This endpoint generates the following events:
- [Channel event](https://developers.pismo.io/events/docs/cash-management-channel-1)

See [Data and reporting](https://developers.pismo.io/pismo-docs/docs/data-reporting-overview) for more information on events and setting up event notifications.

## Request body

- CreateChannelRequest — Request body to create a new channel
  - `channel` string, required — Alphanumeric channel code identifier
  - `description` string — Optional description of the channel

## Response `201`

Created. Returns the created channel.

- CreateChannelResponse — Response body for created channel
  - `channel` string, required — Alphanumeric channel code identifier
  - `created_at` string, date-time, required — Timestamp when the channel was created in RFC3339 format with milliseconds
  - `description` string — Optional description of the channel

## Other responses

- `400` — Bad Request
- `401` — Access token is missing or invalid
- `403` — The request has been lost
- `409` — Conflict. Channel already exists.
- `500` — Internal server error

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)