# Add a room reservation

#### Register the booking to the contact

For hotel or venue integrations, include the embedded [booking](/docs/api-reference/organisation-api/booking.md#get-bookings-id). As soon as the booking exists you should attach it to the contact as an activity.

`POST /activities`

{% code title="" lineNumbers="true" expandable="true" %}

```json
{
  "contact": 1042,
  "type": "Booking",
  "source": "pms",
  "happenedAt": "2026-04-07T10:00:00+00:00",
  "externalReference": "RES-2026-04-1234",
  "booking": {
    "checkIn": "2026-06-15T15:00:00+00:00",
    "checkOut": "2026-06-18T11:00:00+00:00",
    "numberOfGuests": 2,
    "roomType": "Deluxe Double",
    "roomName": "Room 412",
    "total": 45000,
    "currencyCode": "GBP",
    "customerReference": "SMITH-0607",
    "purpose": "Leisure",
    "origin": "Direct"
  }
}
```

{% endcode %}

The booking `total` is also in the smallest currency unit.

View the full [booking](/docs/api-reference/organisation-api/booking.md#get-bookings) object to see what detail can be included.

#### Updating the booking

Bookings will often transition through multiple statuses, once the booking is created as part of the activity it has its own identifier and [can be updated](/docs/api-reference/organisation-api/booking.md#put-bookings-id), you might want to change the following:

* Status
* Total spend
* Room types


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://glu.gitbook.io/docs/use-cases/add-an-activity-to-a-contact/add-a-room-reservation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.