---
title: "Post a message on a BuyBack order"
method: POST
path: "/ws/buyback/v1/orders/{buybackOrderId}/messages"
tags: ["BuyBack"]
---

# Post a message on a BuyBack order

`POST /ws/buyback/v1/orders/{buybackOrderId}/messages`

## Request

- Base URL: `https://preprod.backmarket.co.jp`
- URL: `https://preprod.backmarket.co.jp/ws/buyback/v1/orders/{buybackOrderId}/messages`
- Auth: none declared
- TypeScript: <https://skmtc.dev/backmarket/apis/back-market-api-guidelines/docs/ws/buyback/v1/orders/:buybackOrderId/messages/post.ts> (a function with typed inputs; its response is checked against the schema)

Create BuyBack order messages.
Caller must be an authenticated refurbisher, owner of the provided buyback order.

## Path parameters

- `buybackOrderId` string, required

## Request body

- BuybackMessagePayload
  - `message` string, required: Counter offer explanation message
  - `files` object[], required: Photos supporting the message. If there is no photo, an empty array should be passed.
    - `name` string, required: Name of the photo
    - `content` string, required: Content of the photo

## Response `201`

OK

- BuybackMessage: Buyback order message sent back by 'ws/buyback/' endpoints
  - `body` string: Message content
  - `date` string, required: Message creation date
  - `attachments` string[]
  - `author` 'Merchant' | 'Client' | 'BackMarket' | 'Unknown', required: Message author

## Other responses

- `401`: Unauthorized
- `403`: Permission denied
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Internal Error

---

[API](https://skmtc.dev/backmarket/apis/back-market-api-guidelines.md) - [All operations](https://skmtc.dev/backmarket/apis/back-market-api-guidelines/llms.txt) - [OpenAPI document](https://skmtc.dev/backmarket/apis/back-market-api-guidelines/revisions/30a7402bb310?raw)