---
title: "Create a channel"
method: POST
path: "/distchannels"
tags: ["Channels"]
---

# Create a channel

`POST /distchannels`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/distchannels`
- Auth: OAuth 2
  - Implicit: `https://auth-global.api.smartthings.com`
  - Scopes: `w:channels:*`
- TypeScript: <https://skmtc.dev/smartthings/apis/smartthings-api/docs/distchannels/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a channel for the user making the request

## Request body

- BasicChannel
  - `name` string: Name of the channel
  - `description` string: Description of the channel
  - `type` 'DRIVER': The type of channel
  - `termsOfServiceUrl` string: URL for a developer-provided Terms of Service agreement for the channel

## Response `200`

Newly created channel

- DetailedChannel
  - `channelId` string, uuid: The identifier of the Sprocket channel
  - `name` string: Name of the channel
  - `description` string: Description of the channel
  - `type` 'DRIVER': The type of channel
  - `termsOfServiceUrl` string: URL for a developer-provided Terms of Service agreement for the channel
  - `createdDate` string: The ISO-8601 formatted timestamp when the channel was created
  - `lastModifiedDate` string: The ISO-8601 formatted timestamp when the channel was last modified

## Changes

- **2022-12-19** `adcacfc2749d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartthings/apis/smartthings-api/changes/distchannels/post.md)

---

[API](https://skmtc.dev/smartthings/apis/smartthings-api.md) - [All operations](https://skmtc.dev/smartthings/apis/smartthings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartthings/apis/smartthings-api/revisions/2788a4236800?raw)