Retrieve and manage bookings for a property using the Newbook REST API v2.
domain: developers.newbook.cloud · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Get REST API access enabled for the Newbook account and obtain API credentials from Newbook.
Call the bookings list endpoint to retrieve bookings within a given date/time period rather than pulling the entire booking history at once.
Read the inventory_item array on each booking, including its stay_cost_contribution field (whether an item is included in, increases, or is excluded from the nightly rate).
Paginate list calls with offset/limit parameters and loop until data_count reaches data_total, since results default to a limited page size.
Use the corresponding create/update booking calls to modify a reservation rather than editing inventory_item records outside the booking object.
Known gotchas
Newbook throttles the REST API after around 100 requests per minute — batch or queue high-volume sync jobs instead of polling in a tight loop.
List endpoints are paginated by default, so a naive single-call fetch will silently truncate results for larger properties.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?