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 ->

Booking Custom Attributes

Create and manage booking-related custom attribute definitions and custom attributes.

Use the Booking Custom Attributes API to create and manage custom attributes for bookings to store properties or metadata to support seller-specific customizations of and extensions to the Booking object.

For more information, see the following guides:

  • Booking Custom Attributes.
  • Square Webhooks Overview
  • Endpoints

  • Webhooks

All versions ->

List booking custom attribute definitions

GET/v2/bookings/custom-attribute-definitions

Get all bookings custom attribute definitions.

Create booking custom attribute definition

POST/v2/bookings/custom-attribute-definitions

Creates a bookings custom attribute definition.

Delete booking custom attribute definition

DELETE/v2/bookings/custom-attribute-definitions/{key}

Deletes a bookings custom attribute definition.

Retrieve booking custom attribute definition

GET/v2/bookings/custom-attribute-definitions/{key}

Retrieves a bookings custom attribute definition.

Update booking custom attribute definition

PUT/v2/bookings/custom-attribute-definitions/{key}

Updates a bookings custom attribute definition.

Bulk delete booking custom attributes

POST/v2/bookings/custom-attributes/bulk-delete

Bulk deletes bookings custom attributes.

Bulk upsert booking custom attributes

POST/v2/bookings/custom-attributes/bulk-upsert

Bulk upserts bookings custom attributes.

List booking custom attributes

GET/v2/bookings/{booking_id}/custom-attributes

Lists a booking's custom attributes.

Delete booking custom attribute

DELETE/v2/bookings/{booking_id}/custom-attributes/{key}

Deletes a bookings custom attribute.

Retrieve booking custom attribute

GET/v2/bookings/{booking_id}/custom-attributes/{key}

Retrieves a bookings custom attribute.

Upsert booking custom attribute

PUT/v2/bookings/{booking_id}/custom-attributes/{key}

Upserts a bookings custom attribute.