---
title: "Send an order message"
method: POST
path: "/v1/orders/{orderItemId}/messages"
tags: ["Orders"]
---

# Send an order message

`POST /v1/orders/{orderItemId}/messages`

Send a user message or file upload message on an order timeline. Creates an OrderItemLog entry and notifies the opposing portal.

## Path parameters

- `orderItemId` string, required

## Request body

- object
  - `messageText` string, required — The message text (max 1500 characters)
  - `fileIds` string[] — Array of attached file IDs (presence implies file upload)

## Response `200`

Default Response

- object
  - `success` true, required
  - `logId` string, required — The inserted OrderItemLog _id

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `500` — Default Response

---

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