Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In
  • Home

  • Dev Essentials

  • Payments

  • Commerce

    • Orders

    • Order Custom Attributes

    • Catalog

    • Inventory

    • Transfer Order

    • Bookings

    • Booking Custom Attributes

    • Vendors

    • Channels

    • Sites

    • Snippets

    • Cash Drawers

  • Customers

  • Staff

  • Merchants

  • Objects & Enums

  • Webhook Events

  • Deprecated

  • SDKs

<- Square API

Square API

All versions ->

Bookings

Create and manage bookings for Square sellers with the Bookings API.

The Bookings API allows you to create, retrieve, update, and cancel appointments online. When used with other Square APIs (such as the Locations API, Team API, Catalog API, and Customers API), the Bookings API lets you create online-booking applications for users to book services provided by Square sellers.

Link to section

Why Use the Bookings API?

The Bookings API simplifies the scheduling process for Square sellers and their customers. By integrating with Square’s broader ecosystem, it offers a robust solution for managing appointments. Key Bookings API benefits include:

  • Comprehensive calendar control for sellers, with permissions that allow flexibility in creating bookings.
  • Streamlined buyer-level operations with secure and limited access.
  • Compatibility with Square’s Appointments subscription plans, offering additional features and functionality.
  • Custom attributes to personalize the booking experience.
  • Seamless integration with other Square APIs, such as Customers API, Locations API, Team API, and Catalog API.

For more information, see the following guides:

  • Bookings API Guide
  • Square Webhooks Overview
  • Endpoints

  • Webhooks

All versions ->

booking.created

Published when a booking is created. To receive this event with buyer-level permissions, you must have APPOINTMENTS_READ set for the OAuth scope

booking.updated

Published when a booking is updated or cancelled. To receive this event with buyer-level permissions, you must have APPOINTMENTS_READ set for the OAuth scope