--- title: Now Book It API Integration on Truto slug: nowbookit category: Scheduling canonical: "https://truto.one/integrations/detail/nowbookit/" --- # Now Book It API Integration on Truto **Category:** Scheduling **Status:** Beta ## MCP-ready AI tools Truto exposes 24 tools for Now Book It that AI agents can call directly. - **list_all_now_book_it_bookings** — List NowBookIt bookings with optional filters by service name, date range, or update window. Returns: id, bookingId, locationId. When filtering by date, provide either StartDate + EndDate or UpdatedFromDate + UpdatedToDate. - **create_a_now_book_it_booking** — Create a new booking in NowBookIt. Returns: bookingId, time, duration, id, locationId. Required: numOfPeople. - **get_single_now_book_it_booking_by_id** — Get a single NowBookIt booking by id. Returns: locationId, bookingId, method, bookedAt, bookingTime, duration, people, customer, tables, tags, status, notes, paymentSummary, serviceId, lastModifiedDate, serviceName, serviceType, items, id. Required: id. - **now_book_it_bookings_update_booking_async** — Update an existing booking asynchronously in NowBookIt. Returns: bookingId, time, duration, id, locationId, eventType, data. Required: numOfPeople. - **now_book_it_bookings_update_pax** — Update the party size (pax) for a NowBookIt booking by booking_id. Returns: bookingId, bookingRef, amountSpent, status, pax, locationId, eventType, data. Required: booking_id, pax. - **now_book_it_bookings_update_tables** — Update the tables assigned to a NowBookIt booking by booking_id. Returns an empty 200 response on success. Required: booking_id, tables, allowTableBookingConflict. - **now_book_it_bookings_bulk_update** — Update Booking Status. Returns: bookingId, bookingRef, amountSpent, status, pax. Required: booking_id, status. - **list_all_now_book_it_bookings_schedules** — List available booking schedule time slots in NowBookIt by date range and party size. Returns an array of ScheduleQueryResponse objects whose individual fields are not enumerated in the source documentation. Omit BookingDateTimeEnd for whole-day results; pass BookingId to find alternative timings for an existing booking. Required: booking_date_time_start, num_of_people. - **list_all_now_book_it_bookings_tables** — List bookable tables available in NowBookIt for a given date and duration. Returns: tables. Duration defaults to 90 minutes. Max 100 per page. - **list_all_now_book_it_customers** — List NowBookIt customer profiles with optional filtering by customer ID and last-modified date range, sortable by name. Returns: id, FirstName, LastName, DateUpdated. Max 100 per page. - **now_book_it_customers_unsubscribe** — Unsubscribe a NowBookIt customer from marketing communications by customer_id. Returns an empty 200 response on success. Required: customer_id. - **list_all_now_book_it_gift_cards** — List NowBookIt gift cards filtered by SKU, issue date range, and card status (cancelled, redeemed, expired). Returns: cardNumber, locationId. Max 100 records per page. - **get_single_now_book_it_gift_card_by_id** — Get a single NowBookIt gift card by id. Returns: cardNumber, amount, status, locationId, eventType, data. Required: id. - **now_book_it_gift_cards_redeem** — Redeem a NowBookIt gift card. Returns: cardNumber, amountRedeemed, status, errorMessage, isSuccess, locationId, eventType, data. Required: cardNumber, amount. - **now_book_it_gift_cards_cancel** — Cancel a NowBookIt gift card by card number. Returns an empty response on success. Required: cardNumber. - **create_a_now_book_it_reservation** — Create a new reservation in NowBookIt, pushing it directly from your POS into the venue system. Returns: time, duration. Required: numOfPeople. - **list_all_now_book_it_resources_booking_statuses** — List booking statuses available in Now Book It. Returns a list of booking status objects including id. Max 100 per page. - **list_all_now_book_it_sales** — List NowBookIt sales transactions within a specified date range. Returns: id, attributes. Max 100 records per page. Required: start_date, end_date. - **create_a_now_book_it_sale** — Create a new sale in NowBookIt by submitting a Sales JSON payload, which is matched to an existing booking. Returns an empty 200 response on success. Required: origin, source, type, openedZonedDateTime, staff, table. - **list_all_now_book_it_webhooks** — List all active NowBookIt webhook subscriptions for your location. Returns: authenticationEnabled, event, locationId, webhookUrl, id, eventType, callbackUrl. - **create_a_now_book_it_webhook** — Create a new NowBookIt webhook subscription by subscribing to an event type with a callback URL. Returns: event, webhookUrl, locationId, errorMessage, id, eventType, callbackUrl. Required: webhookUrl, event. - **update_a_now_book_it_webhook_by_id** — Update the callback URL for an existing NowBookIt webhook subscription. Returns: event, webhookUrl, locationId, errorMessage, id, eventType, callbackUrl. Required: id, webhookUrl. - **delete_a_now_book_it_webhook_by_id** — Delete a NowBookIt webhook subscription by id (event name). Returns an empty response on success. Required: id. - **get_single_now_book_it_webhook_by_id** — Get a specific NowBookIt webhook subscription by id (event name). Returns: authenticationEnabled, event, locationId, webhookUrl, id, eventType, callbackUrl, data. Required: id. ## How it works 1. **Link your customer's Now Book It account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Now Book It.** The Proxy API is a 1-to-1 mapping of the Now Book It API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync POS Sales to Reservations** — POS and payment platforms can attribute closed tabs, tips, and gift card redemptions back to specific bookings so venues get accurate guest LTV and spend-per-head data without manual reconciliation. - **Power AI Voice and Chat Booking Agents** — Conversational AI platforms can offer restaurant customers autonomous phone and chat agents that query live schedules, create reservations, and modify party sizes or tables in real time. - **Trigger Lifecycle Marketing from Booking Events** — Marketing and CRM SaaS tools can subscribe to booking status changes via webhooks to send timely pre-arrival reminders, upsells, and post-dining review requests without polling. - **Build Hospitality BI Dashboards** — Analytics platforms can pull bookings, sales, and status data to report on no-show rates, table-turn efficiency, and revenue per cover across single or multi-venue groups. - **Enable Gift Card Commerce** — E-commerce and loyalty apps can validate gift card balances, execute redemptions, and cancel cards, connecting external purchase flows directly into venue transaction records. ## What you can build - **Bi-directional Booking Sync** — List, create, and update bookings — including party size, assigned tables, and status transitions — to keep your product and Now Book It aligned in real time. - **Live Availability Lookup** — Query schedules and table inventory to surface available slots by date, time, and party size inside your own booking interface or AI agent. - **Sales Attribution Pipeline** — Push POS transactions into Now Book It with staff, table, and timestamp metadata to link every dollar spent to the guest and booking that generated it. - **Gift Card Management Module** — Look up gift card balances, process redemptions, and cancel cards from within your commerce or loyalty product. - **Webhook-Driven Automations** — Programmatically create and manage webhook subscriptions so your users can trigger workflows on booking creation, updates, and status changes. - **Customer CRM Sync with Compliance** — Pull customer profiles for segmentation and campaign targeting, and honor unsubscribe events by writing opt-outs back to Now Book It automatically. ## FAQs ### What booking operations are supported through the integration? You can list all bookings, retrieve a single booking by ID, create new bookings and reservations, update party sizes (pax), reassign tables, run async updates, and perform bulk updates on booking statuses. ### How do we get real-time updates instead of polling? Now Book It supports full webhook CRUD via Truto. You can create, retrieve, update, and delete webhook subscriptions programmatically so each of your users receives live events for their venue. ### Can we push POS sales data back into Now Book It? Yes. The create sale endpoint lets you inject transaction data — including staff, table, and timestamp attribution — and you can list sales for reporting and reconciliation. ### Is gift card functionality available via the API? Yes. You can list gift cards, retrieve a single card by ID to check balance and status, redeem cards against transactions, and cancel cards when needed. ### How do we check table availability before booking? Use the schedules endpoint to see available time slots against party size, and the tables endpoint to see capacity and layout details for a venue before creating or updating a booking. ### How do we handle unsubscribe requests for marketing compliance? The customers unsubscribe endpoint lets you write opt-out status back to Now Book It, ensuring that suppressions in your CRM or marketing tool are reflected at the venue level.