# Sales order messages

Section: Sales. Part of the [API reference](https://developer.yoprint.com/reference.md). Web page: https://developer.yoprint.com/reference/sales-order-messages/

This page and all 7 operation pages, in one file: https://developer.yoprint.com/llms/sales-order-messages.txt

The conversation with the customer on an order: its participants and the emails and text messages sent to them.

## Operations (5)

- [Add a participant to an order](https://developer.yoprint.com/reference/sales-order-messages/v1-sales-order-participant-store.md): `POST /v1/api/store/{team_slug}/sales_order/{hash_id}/participant`. Participants are the people who can receive an order's messages: contacts of the customer, or guests with just an email address.
- [List the messages of an order](https://developer.yoprint.com/reference/sales-order-messages/v2-order-message-index.md): `GET /v2/api/store/{team_slug}/v2/sales_order/{hash_id}/message`. Returns the conversation with the customer on a sales order or quote, oldest first, with each message's attachments.
- [List the participants of an order](https://developer.yoprint.com/reference/sales-order-messages/v1-sales-order-participant-index.md): `GET /v1/api/store/{team_slug}/sales_order/{hash_id}/participant`. Participants are the people who can receive an order's messages: contacts of the customer, or guests with just an email address.
- [Send a message to the customer](https://developer.yoprint.com/reference/sales-order-messages/v2-order-message-store.md): `POST /v2/api/store/{team_slug}/v2/sales_order/{hash_id}/message`. Sends a message about a published sales order or quote to its participants, by email or text message, and saves it in the order's conversation.
- [Remove every participant from an order](https://developer.yoprint.com/reference/sales-order-messages/v1-sales-order-participant-clear.md): `PATCH /v1/api/store/{team_slug}/sales_order/{hash_id}/participant/clear`. Removes all participants of a sales order.

## Legacy and internal operations (2)

Prefer the operations above. Legacy ones name their replacement; internal ones are built for YoPrint's own apps.

- [List the messages of an order (v1)](https://developer.yoprint.com/reference/sales-order-messages/v1-sales-order-v1-message-index.md): `GET /v1/api/store/{team_slug}/sales_order/{hash_id}/message` (legacy, deprecated). Returns the same conversation as the v2 list.
- [Send a message to the customer (v1)](https://developer.yoprint.com/reference/sales-order-messages/v1-sales-order-v1-message-store.md): `POST /v1/api/store/{team_slug}/sales_order/{hash_id}/message` (legacy, deprecated). Sends a message like the v2 operation, with the same body, but it also accepts drafts.