# \#booking-api

**URL:** https://developer.squareup.com/forums/tag/booking-api/40.md?match_all_tags=true&page=1&tags%5B%5D=booking-api

[Latest](https://developer.squareup.com/forums/latest.md) · [Categories](https://developer.squareup.com/forums/categories.md) · [Tags](https://developer.squareup.com/forums/tags.md)

**Page:** 2

---

## [Booking API booking status](https://developer.squareup.com/forums/t/booking-api-booking-status/5584)

<div class="topic-metadata">

**Author:** [@ric007](https://developer.squareup.com/forums/u/ric007)\
**Replies:** 5\
**Last updated:** [May 7, 2026, 5:44pm UTC](https://developer.squareup.com/forums/t/booking-api-booking-status/5584 "2026-05-07T17:44:16Z")

</div>

How can i retrieve the status of a booking to see if it has been paid for? Or how can i link the booking to a transaction? Kind Regards, Ric

---

## [How to collect payment for appointment booking using Square's In App Payment SDK](https://developer.squareup.com/forums/t/how-to-collect-payment-for-appointment-booking-using-squares-in-app-payment-sdk/20728)

<div class="topic-metadata">

**Author:** [@Rahul.Codoffer](https://developer.squareup.com/forums/u/Rahul.Codoffer)\
**Replies:** 3\
**Last updated:** [May 7, 2026, 5:43pm UTC](https://developer.squareup.com/forums/t/how-to-collect-payment-for-appointment-booking-using-squares-in-app-payment-sdk/20728 "2026-05-07T17:43:28Z")

</div>

How can i collect the payment for the user’s booking using Square’s In App Payment SDK. and mark the booking as PAID. if there any other way is available then also let me know.

---

## [Suppress customer notification flag to bookings API](https://developer.squareup.com/forums/t/suppress-customer-notification-flag-to-bookings-api/25709)

<div class="topic-metadata">

**Author:** [@dman](https://developer.squareup.com/forums/u/dman)\
**Replies:** 2\
**Last updated:** [May 5, 2026, 8:31pm UTC](https://developer.squareup.com/forums/t/suppress-customer-notification-flag-to-bookings-api/25709 "2026-05-05T20:31:22Z")

</div>

Description: We operate a hair salon with a custom booking system built on the Square Bookings API. We use the API to create, reschedule, and cancel appointments programmatically (via our iOS app and web admin dashboard)…

---

## [Personal Events and One-Time Change/Recurring Schedule Availability](https://developer.squareup.com/forums/t/personal-events-and-one-time-change-recurring-schedule-availability/25040)

<div class="topic-metadata">

**Author:** [@jjt](https://developer.squareup.com/forums/u/jjt)\
**Replies:** 2\
**Last updated:** [May 5, 2026, 6:14pm UTC](https://developer.squareup.com/forums/t/personal-events-and-one-time-change-recurring-schedule-availability/25040 "2026-05-05T18:14:50Z")

</div>

I’m looking to build a system that can automatically apply employee breaks to the schedule based on current bookings and availability. I was initially going to create Personal Events through the API to accomplish this, …

---

## [Appointments: Check-in Event](https://developer.squareup.com/forums/t/appointments-check-in-event/969)

<div class="topic-metadata">

**Author:** [@dfurr](https://developer.squareup.com/forums/u/dfurr)\
**Replies:** 1\
**Last updated:** [May 5, 2026, 6:08pm UTC](https://developer.squareup.com/forums/t/appointments-check-in-event/969 "2026-05-05T18:08:31Z")

</div>

Hey Guys, I’m working with a fairly large barber shop (10+ shops) that recently converted to Square Appointments. They’re looking to notify the barbers when a customer checks in. Their old system had one, but Square App…

---

## [How to link a Payment to an Appointment (API)](https://developer.squareup.com/forums/t/how-to-link-a-payment-to-an-appointment-api/5266)

<div class="topic-metadata">

**Author:** [@diane.uwa](https://developer.squareup.com/forums/u/diane.uwa)\
**Replies:** 12\
**Last updated:** [March 25, 2026, 2:09am UTC](https://developer.squareup.com/forums/t/how-to-link-a-payment-to-an-appointment-api/5266 "2026-03-25T02:09:04Z")

</div>

Hi - I have developed an app that is based on Square Appointment. When a customer pays at the POS for an appointment, the Payment appears on the Booking when I check on the Square Terminal. My question is: How can I re…

---

## [Appointment-to-Payment Matching Challenges](https://developer.squareup.com/forums/t/appointment-to-payment-matching-challenges/25573)

<div class="topic-metadata">

**Author:** [@TCSlaguna](https://developer.squareup.com/forums/u/TCSlaguna)\
**Replies:** 0\
**Last updated:** [March 14, 2026, 8:49pm UTC](https://developer.squareup.com/forums/t/appointment-to-payment-matching-challenges/25573 "2026-03-14T20:49:03Z")

</div>

Hi Everyone! Excuse me for not being technical. I am just a business owner (not a developer) trying to use Claude to get an Appointments report we have been requesting for 8 years. After two hours of vibe coding I am ve…

---

## [Search availability \[should not\] requires segment\_filter](https://developer.squareup.com/forums/t/search-availability-should-not-requires-segment-filter/25487)

<div class="topic-metadata">

**Author:** [@tcj](https://developer.squareup.com/forums/u/tcj)\
**Replies:** 0\
**Last updated:** [March 1, 2026, 10:15pm UTC](https://developer.squareup.com/forums/t/search-availability-should-not-requires-segment-filter/25487 "2026-03-01T22:15:15Z")

</div>

According to the API doc, the segment filters is not required but when I actually call the API it is required. I am also not sure where to get the service\_variation\_id { "errors": \[ { "category": "INVALID\_REQUES…

---

## [Restaurant table booking](https://developer.squareup.com/forums/t/restaurant-table-booking/24767)

<div class="topic-metadata">

**Author:** [@vark](https://developer.squareup.com/forums/u/vark)\
**Replies:** 2\
**Last updated:** [December 11, 2025, 8:07pm UTC](https://developer.squareup.com/forums/t/restaurant-table-booking/24767 "2025-12-11T20:07:25Z")

</div>

Hello. How do you book a table at a restaurant through the API? Currently im using the bookings API for testing, and in it, there’s the search\_availability endpoint which returns the available slots. But it requires ser…

---

## [Appointments not showing on my sandbox](https://developer.squareup.com/forums/t/appointments-not-showing-on-my-sandbox/24568)

<div class="topic-metadata">

**Author:** [@aseawright](https://developer.squareup.com/forums/u/aseawright)\
**Replies:** 6\
**Last updated:** [November 27, 2025, 1:28am UTC](https://developer.squareup.com/forums/t/appointments-not-showing-on-my-sandbox/24568 "2025-11-27T01:28:56Z")

</div>

Hello, I am trying to test the book appointment feature in my sandbox, but it does not show on my left menu. My only options are Sandbox Default Test Account Home Items & services Payments & invoices Customers Rep…

---

## [Creating a new class adds only location to "absent\_at\_location\_ids" array](https://developer.squareup.com/forums/t/creating-a-new-class-adds-only-location-to-absent-at-location-ids-array/23909)

<div class="topic-metadata">

**Author:** [@champquin](https://developer.squareup.com/forums/u/champquin)\
**Replies:** 23\
**Last updated:** [September 12, 2025, 5:17pm UTC](https://developer.squareup.com/forums/t/creating-a-new-class-adds-only-location-to-absent-at-location-ids-array/23909 "2025-09-12T17:17:41Z")

</div>

When I create a new class to use the bookings api, every location in my account (only 1) is added to the absent\_at\_locations\_id array. Thus I cannot query available bookings.

---

## [List Bookings API Issue](https://developer.squareup.com/forums/t/list-bookings-api-issue/23900)

<div class="topic-metadata">

**Author:** [@marda](https://developer.squareup.com/forums/u/marda)\
**Replies:** 1\
**Last updated:** [September 8, 2025, 4:12pm UTC](https://developer.squareup.com/forums/t/list-bookings-api-issue/23900 "2025-09-08T16:12:00Z")

</div>

In order to retrieve and list all bookings, it is logical that I should be able to retrieve recurring bookings (of course, within a certain time period). The API does not appear to currently support this. I have seen oth…

---

## [Square appointments allow double booking at a certain time](https://developer.squareup.com/forums/t/square-appointments-allow-double-booking-at-a-certain-time/22869)

<div class="topic-metadata">

**Author:** [@marquessmalley](https://developer.squareup.com/forums/u/marquessmalley)\
**Replies:** 2\
**Last updated:** [June 20, 2025, 3:31pm UTC](https://developer.squareup.com/forums/t/square-appointments-allow-double-booking-at-a-certain-time/22869 "2025-06-20T15:31:53Z")

</div>

I am using the square booking api in my custom app. When I book an appointment at say 1pm for example, then I try to book again for that sametime, square allows this double booking. How can I prevent double bookings, so …

---

## [Booking api for swiss based Website](https://developer.squareup.com/forums/t/booking-api-for-swiss-based-website/22867)

<div class="topic-metadata">

**Author:** [@hindujafamilyswiss](https://developer.squareup.com/forums/u/hindujafamilyswiss)\
**Replies:** 1\
**Last updated:** [June 20, 2025, 3:31pm UTC](https://developer.squareup.com/forums/t/booking-api-for-swiss-based-website/22867 "2025-06-20T15:31:12Z")

</div>

My Hinduja Family Swiss lives in Switzerland so i want to create booking api for swiss based website . So what is procedure to integrate it. Regards: Hinduja Family Swiss

---

## [Unable to access BookingCustomAttributes endpoints](https://developer.squareup.com/forums/t/unable-to-access-bookingcustomattributes-endpoints/22733)

<div class="topic-metadata">

**Author:** [@rajs1711](https://developer.squareup.com/forums/u/rajs1711)\
**Replies:** 1\
**Last updated:** [June 11, 2025, 6:07pm UTC](https://developer.squareup.com/forums/t/unable-to-access-bookingcustomattributes-endpoints/22733 "2025-06-11T18:07:09Z")

</div>

I am trying to access the POST /v2/bookings/custom-attribute-definitions - Square API Reference and POST /v2/bookings/custom-attributes/bulk-delete - Square API Reference these endpoints and it seems they require APPOINT…

---

## [Successful Bookings not showing in square dashboard](https://developer.squareup.com/forums/t/successful-bookings-not-showing-in-square-dashboard/22572)

<div class="topic-metadata">

**Author:** [@marquessmalley](https://developer.squareup.com/forums/u/marquessmalley)\
**Replies:** 5\
**Last updated:** [May 29, 2025, 12:10am UTC](https://developer.squareup.com/forums/t/successful-bookings-not-showing-in-square-dashboard/22572 "2025-05-29T00:10:55Z")

</div>

I’ve created multiple successful bookings in my app and square api explorer but when I try to view them in square dashboard, nothing appears. I am getting successful logs in my dev account and when use the list bookings…

---

## [Booking API -\> Retrieve booking -\> "any\_team\_member": false](https://developer.squareup.com/forums/t/booking-api-retrieve-booking-any-team-member-false/21518)

<div class="topic-metadata">

**Author:** [@trungcoder1983](https://developer.squareup.com/forums/u/trungcoder1983)\
**Replies:** 10\
**Last updated:** [April 1, 2025, 10:59pm UTC](https://developer.squareup.com/forums/t/booking-api-retrieve-booking-any-team-member-false/21518 "2025-04-01T22:59:40Z")

</div>

I tried to use the \[Retrieve booking API\] to query a customer appointment. On Square’s Appointment App, the appointment has the property: (Booked with any available). However, the Response returned to me is always: \[“any…

---

## [List bookings API returns different appt counts than "Team Performance" report](https://developer.squareup.com/forums/t/list-bookings-api-returns-different-appt-counts-than-team-performance-report/21226)

<div class="topic-metadata">

**Author:** [@robertoryan](https://developer.squareup.com/forums/u/robertoryan)\
**Replies:** 6\
**Last updated:** [February 28, 2025, 12:02am UTC](https://developer.squareup.com/forums/t/list-bookings-api-returns-different-appt-counts-than-team-performance-report/21226 "2025-02-28T00:02:43Z")

</div>

I’m working as a developer for a store owner who wants custom reporting for his Appointments. I’ve been using the GET/v2/bookings List bookings API to list all appointments in a given month. The strange thing is … the AP…

---

## [Unable to schedule past 32 days?](https://developer.squareup.com/forums/t/unable-to-schedule-past-32-days/21198)

<div class="topic-metadata">

**Author:** [@iwanttocry](https://developer.squareup.com/forums/u/iwanttocry)\
**Replies:** 3\
**Last updated:** [February 25, 2025, 10:23pm UTC](https://developer.squareup.com/forums/t/unable-to-schedule-past-32-days/21198 "2025-02-25T22:23:15Z")

</div>

I’m using this app as a starting point: https://www.youtube.com/watch?v=vTfDarZlNiU But I’m unable to schedule past 30-32 days? That’s not useful at all, my grooming clients are typically on a 6-8 week schedule. How can…

---

## [Get Booking amount from API call](https://developer.squareup.com/forums/t/get-booking-amount-from-api-call/15791)

<div class="topic-metadata">

**Author:** [@anassdev](https://developer.squareup.com/forums/u/anassdev)\
**Replies:** 11\
**Last updated:** [January 22, 2025, 10:08pm UTC](https://developer.squareup.com/forums/t/get-booking-amount-from-api-call/15791 "2025-01-22T22:08:35Z")

</div>

Hey, I’m using a webhook that triggers when a new appointment is made, in order to activate my automated flow. The issue i’m having is i can’t find the booking amount in the webhook data,is there a way to get this infor…

---

## [Webhook Events for Bookings of type "Class (Plus)"](https://developer.squareup.com/forums/t/webhook-events-for-bookings-of-type-class-plus/20222)

<div class="topic-metadata">

**Author:** [@mtlberri](https://developer.squareup.com/forums/u/mtlberri)\
**Replies:** 3\
**Last updated:** [December 31, 2024, 10:03pm UTC](https://developer.squareup.com/forums/t/webhook-events-for-bookings-of-type-class-plus/20222 "2024-12-31T22:03:00Z")

</div>

Is there a Webhook event for square sellers creating bookings of type “Class” ? (group of customers) I searched for it but could not find any documentation beyond the normal booking appointment for a single customer. …

---

## [Bookings API: envoy has no route for the specified Host header](https://developer.squareup.com/forums/t/bookings-api-envoy-has-no-route-for-the-specified-host-header/20206)

<div class="topic-metadata">

**Author:** [@Desmond](https://developer.squareup.com/forums/u/Desmond)\
**Replies:** 6\
**Last updated:** [December 22, 2024, 7:45am UTC](https://developer.squareup.com/forums/t/bookings-api-envoy-has-no-route-for-the-specified-host-header/20206 "2024-12-22T07:45:53Z")

</div>

The search availabilities endpoint has been returning the following error “envoy has no route for the specified Host header. Visit https://go/envoynoroute for debugging help.”. Please help as this is blocking our integra…

---

## [Booking API in Sandbox is not working](https://developer.squareup.com/forums/t/booking-api-in-sandbox-is-not-working/19781)

<div class="topic-metadata">

**Author:** [@ZAYAN](https://developer.squareup.com/forums/u/ZAYAN)\
**Replies:** 1\
**Last updated:** [November 25, 2024, 6:24pm UTC](https://developer.squareup.com/forums/t/booking-api-in-sandbox-is-not-working/19781 "2024-11-25T18:24:28Z")

</div>

I am facing the similar issue. I have tried the free subscription plan but still it gives me the same error. my my app id is: sq0idp-lpW4NIvwSuPvJzu3oxsOdA

---

## [Can I get the user email when the \`booking.created\` event is fired?](https://developer.squareup.com/forums/t/can-i-get-the-user-email-when-the-booking-created-event-is-fired/19274)

<div class="topic-metadata">

**Author:** [@rydensun](https://developer.squareup.com/forums/u/rydensun)\
**Replies:** 6\
**Last updated:** [October 25, 2024, 1:04am UTC](https://developer.squareup.com/forums/t/can-i-get-the-user-email-when-the-booking-created-event-is-fired/19274 "2024-10-25T01:04:20Z")

</div>

I’m building an integration where, after the booking.created event is triggered, I want to automatically send an email reminding the customer to sign a waiver. Currently, I can see that the webhook includes a customer\_id,…

---

## [How can I retrieve variable pricing set during booking from my backend?](https://developer.squareup.com/forums/t/how-can-i-retrieve-variable-pricing-set-during-booking-from-my-backend/18726)

<div class="topic-metadata">

**Author:** [@siumgg](https://developer.squareup.com/forums/u/siumgg)\
**Replies:** 2\
**Last updated:** [September 13, 2024, 9:56pm UTC](https://developer.squareup.com/forums/t/how-can-i-retrieve-variable-pricing-set-during-booking-from-my-backend/18726 "2024-09-13T21:56:37Z")

</div>

Hello Square Developer Community, I’m working on an integration where I allow customers to set dynamic prices for services through the Square app, specifically using the VARIABLE\_PRICING option in the service settings. …

---

## [List Bookings returns empty response](https://developer.squareup.com/forums/t/list-bookings-returns-empty-response/18021)

<div class="topic-metadata">

**Author:** [@stigjen](https://developer.squareup.com/forums/u/stigjen)\
**Replies:** 2\
**Last updated:** [July 29, 2024, 4:20pm UTC](https://developer.squareup.com/forums/t/list-bookings-returns-empty-response/18021 "2024-07-29T16:20:54Z")

</div>

Using the NodeJS SDK, I’ve created a bunch of bookings. I’m able to log out the response and see the BookingId. When I call GetBooking with this ID, I get a response - but when I call ListBookings, the response is empty…

---

## [Booking.update webhook not triggering on booking status updates](https://developer.squareup.com/forums/t/booking-update-webhook-not-triggering-on-booking-status-updates/17454)

<div class="topic-metadata">

**Author:** [@fabpicca](https://developer.squareup.com/forums/u/fabpicca)\
**Replies:** 2\
**Last updated:** [June 28, 2024, 4:33pm UTC](https://developer.squareup.com/forums/t/booking-update-webhook-not-triggering-on-booking-status-updates/17454 "2024-06-28T16:33:32Z")

</div>

Hello, I noticed that if I change the status of a Booking within the dashboard (i.e. Confirming a booking), the booking.updated webhook is not triggered. Is this the expected behaviour? It would be great to have the pos…

---

## [Appointments calendar with correct time zone](https://developer.squareup.com/forums/t/appointments-calendar-with-correct-time-zone/6518)

<div class="topic-metadata">

**Author:** [@bk52](https://developer.squareup.com/forums/u/bk52)\
**Replies:** 9\
**Last updated:** [April 10, 2024, 5:42pm UTC](https://developer.squareup.com/forums/t/appointments-calendar-with-correct-time-zone/6518 "2024-04-10T17:42:53Z")

</div>

I get a warning “Calendar time zone (+03) differs from business time zone (CDT)”. How can i set correct time zone for Calendar? And my business hours below. But it doesn’t match with calendar.

---

## [Charging for collaboration package and separating payment to both businesses](https://developer.squareup.com/forums/t/charging-for-collaboration-package-and-separating-payment-to-both-businesses/12781)

<div class="topic-metadata">

**Author:** [@aquapodicsmqt](https://developer.squareup.com/forums/u/aquapodicsmqt)\
**Replies:** 3\
**Last updated:** [February 24, 2024, 2:13am UTC](https://developer.squareup.com/forums/t/charging-for-collaboration-package-and-separating-payment-to-both-businesses/12781 "2024-02-24T02:13:50Z")

</div>

We are doing a collaboration package on our website with a business we share a location with. is there a way to collect payment from customers online and/or on site that will divide the payment and deposit a set portion …

---

## [Empty location when creating a booking with API using location\_type "CUSTOMER\_LOCATION"](https://developer.squareup.com/forums/t/empty-location-when-creating-a-booking-with-api-using-location-type-customer-location/10385)

<div class="topic-metadata">

**Author:** [@dtklassy](https://developer.squareup.com/forums/u/dtklassy)\
**Replies:** 16\
**Last updated:** [January 3, 2024, 1:34am UTC](https://developer.squareup.com/forums/t/empty-location-when-creating-a-booking-with-api-using-location-type-customer-location/10385 "2024-01-03T01:34:39Z")

</div>

I’m developing a small app using python to create bookings for our business, but am running into an issue. When creating a booking, the location field shows as empty in the booking, and in the calendar, despite the custo…

[Previous page](https://developer.squareup.com/forums/tag/booking-api/40.md?match_all_tags=true&tags%5B%5D=booking-api)

[Next page](https://developer.squareup.com/forums/tag/booking-api/40.md?match_all_tags=true&page=2&tags%5B%5D=booking-api)
