Disclaimer: API endpoints, authentication flows, and rate limits are subject to change by SevenRooms. Always refer to the official, live documentation in the Developer Portal for the most current specifications.
While the SevenRooms API is powerful, working with it effectively requires planning and understanding of its technical nuances.
: Creates a new reservation. Requires a valid venue ID, guest ID, party size, and date/time.
The guest object is the atomic unit of SevenRooms. Every diner, walk-in, or regular gets a guest_id .
The future of hospitality is connected, real-time, and guest-centric. With the SevenRooms API documentation as your blueprint, you are ready to build it. sevenrooms api documentation
In the rapidly evolving landscape of hospitality technology, data silos are the enemy of efficiency. SevenRooms, a leading guest experience and reservation platform, has empowered thousands of restaurants, hotels, nightclubs, and venues to consolidate their operations. However, the true power of SevenRooms is unlocked when it talks to your other tools—your CRM, marketing automation, POS, or custom dashboard.
Never expose API keys in client-side code. Use environment variables.
: Modify a reservation status (e.g., changing status from "Booked" to "Arrived"). 5. Handling Real-Time Data with Webhooks
The SevenRooms API documentation categorizes endpoints by their primary resource. Understanding these core objects is crucial for mapping out your integration data flow. 1. Venues ( /v1/venues ) : Creates a new reservation
– Fetch reservations within a date range. Supports query params: start_date , end_date , venue_id , status (e.g., confirmed , seated , completed ). POST /reservations – Create a booking. You must reference an existing guest_id or create a guest on the fly using nested objects. DELETE /reservations/reservation_id – Cancel a reservation (requires a cancellation_reason parameter in the body).
Let’s translate the documentation into real-world scenarios.
Ensure you consult the SevenRooms Developer Portal for the most up-to-date OAuth2 flow. Top API Integration Use Cases
Let’s dissect the most frequently used sections of the . While the full API has dozens of endpoints, these five categories will cover 90% of common integrations. Every diner, walk-in, or regular gets a guest_id
By following the SevenRooms API documentation, you can integrate their powerful hospitality CRM features into your custom applications and unlock new possibilities for your business.
For standard token-based requests, the API key must be included in the HTTP headers of every request:
To obtain your API credentials, follow this process: