# Messages

Section: Messages and activity. Part of the [API reference](https://developer.yoprint.com/reference.md). Web page: https://developer.yoprint.com/reference/messages/

This page and all 8 operation pages, in 2 files: https://developer.yoprint.com/llms/messages.txt (operations 1 to 3), https://developer.yoprint.com/llms/messages-2.txt (operations 4 to 8)

Your team's whole message inbox: emails and texts exchanged with customers and vendors on all sales orders, quotes and purchase orders, with their delivery status. Read them, retry failed deliveries and set a message status here. To send a message on one order, use Sales order messages.

## Operations (8)

- [List messages](https://developer.yoprint.com/reference/messages/v2-messages-index.md): `GET /v2/api/store/{team_slug}/messages`. Lists the messages on your team's sales orders, quotes and purchase orders, newest first: emails and texts you sent to customers and vendors, and the replies they sent back.
- [List a message's recipients](https://developer.yoprint.com/reference/messages/v2-messages-recipients-index.md): `GET /v2/api/store/{team_slug}/messages/{hash_id}/recipients`. Lists everyone a message was sent to, with how delivery went for each: the address or number it went to at the time, the channel (`email` or `sms`), the status, and the provider's error when it…
- [Filter messages](https://developer.yoprint.com/reference/messages/v2-messages-filter.md): `POST /v2/api/store/{team_slug}/messages/filter`. Lists messages like `GET /v2/api/store/{team_slug}/messages`, narrowed by direction or status, with an optional sort.
- [Get a message](https://developer.yoprint.com/reference/messages/v2-messages-show.md): `GET /v2/api/store/{team_slug}/messages/{hash_id}`. Returns one message in full: the message as written (`message`), the whole message as HTML (`original_message`), attachments, recipients with their delivery status, its team status, and `retryable`…
- [Get one recipient of a message](https://developer.yoprint.com/reference/messages/v2-messages-recipients-show.md): `GET /v2/api/store/{team_slug}/messages/{hash_id}/recipients/{id}`. Returns one recipient's delivery: where it was sent, the channel, the status and any provider error.
- [Retry delivery to one recipient](https://developer.yoprint.com/reference/messages/v2-messages-recipients-retry.md): `PUT /v2/api/store/{team_slug}/messages/{hash_id}/recipients/{id}/retry`. Sends the message again to one recipient whose delivery failed.
- [Retry a message's failed deliveries](https://developer.yoprint.com/reference/messages/v2-messages-retry.md): `PUT /v2/api/store/{team_slug}/messages/{hash_id}/retry` (spends money). Sends an outbound message again to the recipients it failed to reach.
- [Set a message's status](https://developer.yoprint.com/reference/messages/v2-messages-status.md): `PUT /v2/api/store/{team_slug}/messages/{hash_id}/status`. Sets your team's own status on a message, such as "Need to Respond" or "Completed", for sorting your inbox.
