Skip to main content

Create a board channel

POST 

/api/v4/boards

Experimental: This endpoint is experimental and may change or be removed in a future release.

Create a new board channel. Boards are channels with a kanban view backed by linked properties (status and assignee by default), and live alongside regular channels but cannot be created or modified through the /api/v4/channels endpoints.

The request body is a Channel object whose type must be BO (open board) or BP (private board). team_id and display_name are required.

This endpoint is gated behind the IntegratedBoards feature flag. When the flag is off, the route is not registered and requests return 404.

Permissions

Must have create_public_channel for type BO, or create_private_channel for type BP, on the target team.

Request

Responses

Board channel creation successful