---
title: "Attach a posting room from an order"
method: POST
path: "/shop/orders/{orderId}/posting-room"
tags: ["Orders"]
---

# Attach a posting room from an order

`POST /shop/orders/{orderId}/posting-room`

Use this endpoint to attach a posting room to an order.

## Request body

- object
  - `posting_room_data` object, required — Free-form key/value bag identifying the PMS folio that charges from this order should be posted to. The exact shape depends on the PMS in use (e.g. Opera, Cloudbeds); Trybe forwards the data verbatim to the integration. Use `null` to detach a previously-attached posting room.

## Response `200`

The `PostingRoom` was successfully associated to the `Order`

- object
  - `data` PostingRoom — A link between an order and a hotel-PMS room folio so that the order's balance can be "posted to room" rather than settled at checkout. Captures the PMS room number, guest reference and timestamp of the association, plus the integration outcome.
    - `associated_at` string, date-time, nullable, required — The date and time the posting room was associated to the order. If not provided, the current date and time will be used.
    - `processor_data` object, nullable, required — The name of the room to attach to the [`Order`](/endpoints/Orders).

## Other responses

- `404` — The resource couldn't be found

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)