# OR42 - Post a message on an order (deprecated)

Customer will be created if it does not exist. Otherwise, every field will be updated (optional fields will be updated only if present). Maximum of 1000 messages on a threadCall FrequencyRecommended usage: At each new message posted on an orderMaximum usage: At each new message posted on an orderRead MoreMore context (message integration)More context (message attachment)More context (sellers)

Endpoint: POST /api/orders/{order_id}/messages

## Path parameters:

  - `order_id` (string, required)
    Order identifier

## Request fields (application/json):

  - `body` (string, required)
    Body of the message

  - `customer_email` (string, required)
    Email of the customer who sent the message. Required only if the customer sent the message. Otherwise, do not define.

  - `customer_firstname` (string, required)
    First name of the customer who sent the message. Required only if the customer sent the message. Otherwise, do not define.

  - `customer_id` (string, required)
    Id of the customer who sent the message. Required only if the customer sent the message. Otherwise, do not define.

  - `customer_lastname` (string, required)
    Last name of the customer who sent the message. Required only if the customer sent the message. Otherwise, do not define.

  - `customer_locale` (string)
    Locale of the customer who sent the message

  - `document_ids` (array)
    Message's attachments. List of document ids already linked to the order. Use OR74 to upload new documents and OR72 to retrieve their ids. NB: If one of those document_id have already been linked to a previous message, it will be ignored.

  - `subject` (string, required)
    Subject of the message

  - `to_customer` (boolean, required)
    Boolean to indicate the message will be sent to the customer associated with the order.

  - `to_operator` (boolean, required)
    Boolean to indicate the message will be sent to the operator.

  - `to_shop` (boolean, required)
    Boolean to indicate the message will be sent to the shop associated with the order

## Response 201 fields (application/json):

  - `id` (integer, required)
    Identifier of the message created