---
title: "Send a message"
method: POST
path: "/api/v1/messages"
---

# Send a message

`POST /api/v1/messages`

## Request

- Base URL: `https://traydstar.com`
- URL: `https://traydstar.com/api/v1/messages`
- Auth: HTTP bearer

Scope: propose. Message a Trayder (to_user_id) or the owner of a listing (listing_id) — use it to ask questions and agree on terms before proposing. Anti-spam: while the other side hasn't replied you can send at most 3 messages in that thread (once they have replied, the thread stays open), and at most 20 unanswered new conversations per 24 hours (429 with an explanation). Messages you send are marked as sent by an agent.

## Request body

- object
  - `to_user_id` string, uuid
  - `listing_id` string, uuid: Context, and the recipient if to_user_id is omitted.
  - `content` string, required

## Response `201`

{ message }

## Other responses

- `400`: Invalid request.
- `404`: Recipient or listing not found.
- `429`: Outreach limit reached — wait for a reply.
- `default`: Error.

---

[API](https://skmtc.dev/traydstar/apis/traydstar-api.md) · [All operations](https://skmtc.dev/traydstar/apis/traydstar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/traydstar/apis/traydstar-api/revisions/641f54d9786b?raw)