---
title: "Send a message"
method: POST
path: "/chats/{userUuid}/message"
---

# Send a message

`POST /chats/{userUuid}/message`

Send a message to a user in an existing chat conversation. The message can include text, media attachments, and optional pricing for pay-to-view content, or a single third-party GIF (`gif`) in place of text and media.

## Path parameters

- `userUuid` string, uuid, required

## Headers

- `X-Fanvue-API-Version` string, required

## Request body

- object
  - `text` string, nullable
  - `gif` object — A third-party GIF to send in place of media. May be sent on its own or alongside `text`, which is rendered as a caption. Cannot be combined with `mediaUuids`, `mediaPreviewUuid`, `price` or `templateUuid`.
    - `id` string, required — The GIF provider's durable identifier for this GIF (as returned on a GIF message)
    - `format` 'GIF' | 'WEBP', required — Encoding of the asset at `url`
    - `title` string, nullable — Human-readable GIF title, used as alt text. Accepts null as well as omission, so the `gif` block returned by a read can be sent back unchanged.
    - `url` string, uri, required — Hotlink URL of the GIF on the provider's CDN
    - `width` integer, required — Intrinsic width of the asset at `url`, in pixels
    - `height` integer, required — Intrinsic height of the asset at `url`, in pixels
  - `mediaUuids` string[]
  - `mediaPreviewUuid` string, uuid, nullable — UUID of a single media item shown for free as a preview of a pay-to-view message. Requires a price and attached media (or a template).
  - `price` number, nullable
  - `templateUuid` string, uuid, nullable

## Response `201`

Message sent successfully

- object
  - `messageUuid` string, uuid, required

## Other responses

- `400` — Bad Request - API version not supported OR user contactability validation failed OR message validation failed
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded

---

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