# The Message object

> Attributes of a BloomText Message and the endpoints that return it.

Source: https://www.bloomtext.com/developers/api/reference/message-object/

Messages and threaded replies.

### Attributes

- `id` (UUID, required): Unique ID of the message.

- `conversation_id` (UUID, required): Conversation the message was sent in.

- `sender_id` (UUID, required): User or app user who sent the message.

- `created_at` (timestamp, required): When the message was sent.

- `type` (text, file, required): Whether the message carries text or a file.

- `body` (string or null): Message text. Null for file messages.

- `file` (FileReference or null): File metadata. Null for text messages.

  Child attributes:
- `id` (UUID, required): Unique ID of the file.

- `name` (string, required): Original file name.

- `mime` (string or null): MIME type, such as `application/pdf`.

- `size_bytes` (integer or null): File size in bytes.

- `reply_to_message_id` (UUID or null): Message this is a reply to. Null for top-level messages.

### Endpoints

| Method | Path | Endpoint |
| --- | --- | --- |
| GET | `/conversations/{conversationId}/messages` | [List messages](https://www.bloomtext.com/developers/api/reference/list-messages/) |
| POST | `/conversations/{conversationId}/messages` | [Send a message](https://www.bloomtext.com/developers/api/reference/create-message/) |
| GET | `/messages/{messageId}/replies` | [List replies to a message](https://www.bloomtext.com/developers/api/reference/list-replies/) |

```json filename="The Message object"
{
  "id": "4cbfdb50-6b7d-45d4-94b3-05a52ce3f4d1",
  "conversation_id": "e5c3b7b8-8f08-4d5a-9af1-0d11b0f4b7a0",
  "sender_id": "8b9c2d2f-6b1a-44f4-a7b1-0d6d3f2d6f55",
  "created_at": "2026-09-21T15:04:05Z",
  "type": "text",
  "body": "Your appointment is confirmed for Tuesday at 10:00.",
  "file": null,
  "reply_to_message_id": null
}
```