---
title: "Send a Custom Chat Message"
method: POST
path: "/{chat_room_id}/custom-messages/"
---

# Send a Custom Chat Message

`POST /{chat_room_id}/custom-messages/`

Send a custom message to a chat room.  This can be used to send rich data as a chat message that can be interpreted by the SDK to perform some action or display additional content.

## Path parameters

- `chat_room_id` string, required

## Request body

- object
  - `custom_data` string, required — String data to send with the chat message. Typically contains a string JSON payload to be decoded by the client SDK
  - `program_date_time` string, date — ISO-8601 Program Date Time to associate with the chat message.

## Response `201`

201

- object
  - `id` string
  - `chat_room_id` string
  - `sender_id` string
  - `sender_nickname` string
  - `sender_image_url` unknown
  - `badge_image_url` unknown
  - `sender_profile_url` string
  - `created_at` string
  - `custom_data` string
  - `program_date_time` unknown

## Other responses

- `403` — 403

---

[API](https://skmtc.net/livelike/apis/engagement-suite.md) · [All operations](https://skmtc.net/livelike/apis/engagement-suite/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/livelike/engagement-suite/revisions/f3171d1c30f7/schema)