---
title: "Create Message Channel"
method: POST
path: "/v1/message-channels"
---

# Create Message Channel

`POST /v1/message-channels`

This API endpoint creates a new message channel. See the [Message Channel](https://docs.assembly.com/reference/message-channels) resource for detailed descriptions of the properties.

## Request body

- object
  - `membershipType` string, required — The type of membership that this channel is associated with. Can be one of `individual`, `group` or `company`.
  - `membershipEntityId` string — Deprecated. Use clientId and companyId instead.
  - `memberIds` string[] — The `id`s of the clients to be added to this particular channel. Required for `group` channels. Ignored for `individual` and `company` channels.
  - `clientId` string — The id of the client this channel is for. Required for individual channels.
  - `companyId` string — The id of the company this channel belongs to. Required for company channels and when the client(s) members have multiple companies.

## Response `200`

200

- object
  - `id` string
  - `object` string
  - `createdAt` string
  - `updatedAt` string
  - `membershipType` string
  - `clientId` string
  - `companyId` string
  - `membershipEntityId` string
  - `memberIds` string[]
  - `lastMessageDate` unknown

## Other responses

- `400` — 400

---

[API](https://skmtc.net/assembly/apis/core-resources.md) · [All operations](https://skmtc.net/assembly/apis/core-resources/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/assembly/core-resources/versions/28a9e7d13a8c/schema)