---
title: "Create Chat Message"
method: POST
path: "/v4/chat/{section_uuid}/{chat_uuid}/messages"
tags: ["ChatMessage"]
---

# Create Chat Message

`POST /v4/chat/{section_uuid}/{chat_uuid}/messages`

## Request

- Base URL: `https://chat.viafoura.co`
- URL: `https://chat.viafoura.co/v4/chat/{section_uuid}/{chat_uuid}/messages`
- Auth: one of:
  - HTTP basic
  - API key in header `X-REQUEST_SIGNATURE`

Create a message in a chat.

## Path parameters

- `section_uuid` string, uuid, required
- `chat_uuid` string, uuid, required

## Request body

- ContentRequest
  - `content` string, nullable
  - `media_uuids` string[], nullable
  - `metadata` ContentInstanceMetadata, nullable: Metadata captured or assigned during content creation
    - `author_host_section_uuid` string, uuid, nullable: Identifier for where the author of the content is hosted. Facilitates looking up information about the author
    - `origin_title` string, nullable: Title of the location where the content was created
    - `origin_summary` string, nullable: Short description about the location where the content was created
    - `origin_url` string, nullable: Location where the content was created
    - `origin_image_url` string, nullable: Location of the icon or thumbnail representing the origin
    - `origin_image_alt` string, nullable: Text description of the origin_image_url
    - `origin_ip_address` string, nullable: Ip address of the user during content creation. Only returned to client permission bearers

## Response `201`

Created

- ContentCreateResponse
  - `content_uuid` string, uuid

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/viafoura/apis/live-chat-api.md) - [All operations](https://skmtc.dev/viafoura/apis/live-chat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/viafoura/apis/live-chat-api/revisions/8752e547d2d9?raw)