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

# Create channel

`POST /corporate/v1/channels`

## Request

- Base URL: `https://sandbox.pismolabs.io`
- URL: `https://sandbox.pismolabs.io/corporate/v1/channels`
- Auth: HTTP bearer

Creates a new channel for transaction routing and control.<br>

A channel is a client‑defined code that identifies the source of a payment or cash‑management operation. It controls how back‑business‑date transactions are handled and determines whether a transaction can bypass cutoff rules, since only active channels in the allowed set can override the cutoff. Channels also enable routing based on the transaction’s source.

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

Refer to [Data and reporting](doc:data-reporting-overview) for more information about 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: Text describing the channel

## Response `201`

Created. Returns the created channel.

- CreateChannelResponse: Response body for created channel
  - `channel` string, required: Alphanumeric channel code
  - `created_at` string, date-time, required: Timestamp indicating when the channel was created, expressed in RFC3339 format with millisecond precision.
  - `description` string: Text describing 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/banking-transaction-banking.md) - [All operations](https://skmtc.dev/pismo/apis/banking-transaction-banking/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/banking-transaction-banking/revisions/1334306c9303?raw)