---
search:
  tags:
    - Orders
    - POST
seo:
  description: >-
    Adds a message to the order's conversation, authored by the token's user…
    Reference for the POST /orders/{order_id}/messages endpoint in the Bolder
    API v2.
sidebar:
  label: Send an order message or note
  badge: POST
title: Send an order message or note
type: openapi-operation
---
Adds a message to the order's conversation, authored by the token's user (`422` on `$.base`
without one). External messages (default) are visible to the customer; `internal: true` adds a
staff note. `notify: true` (external only, `422` on `$.notify` otherwise) also emails the message
to the customer after it is saved. The order must have a contact (`422` on `$.order`). Unknown
fields answer `422`. Needs the full `orders.write` scope; the `_own` scopes get `403`.

`POST /orders/{order_id}/messages`

**Request body** (`application/json`, required)

- `body` (string, required)
- `internal` (boolean)
- `notify` (boolean)

Request body example:

```json
{
  "body": "Tu visita quedo agendada para el martes.",
  "notify": true
}
```

**Responses**

- `201` — Message created
- `422` — Invalid body, unknown field, \`notify\` on a note, no user on the token, or order without contact.

Response example, 201:

```json
{
  "id": 0,
  "body": "string",
  "internal": true,
  "sender": "admin",
  "author": {
    "id": 0,
    "name": "string"
  },
  "created_on": "2019-08-24T14:15:22Z"
}
```