{
  "info": {
    "_postman_id": "4741d1de-da3f-4d16-a30c-174757ae46bb",
    "name": "Square ApplePay BookingCustomAttributes API",
    "description": "Supercharge Square for sellers of every size. Our entire connected commerce platform  from elegant hardware to a rich suite of Square APIs  is yours to build with. Whether youre developing an app or composing a bespoke solution, this is the place to make it happen. \n\nContact Support:\n Name: Square Developer Platform\n Email: developers@squareup.com",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T03:01:43.000Z",
    "updatedAt": "2026-07-28T03:01:43.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-4741d1de-da3f-4d16-a30c-174757ae46bb"
  },
  "item": [
    {
      "name": "v2",
      "item": [
        {
          "name": "bookings",
          "item": [
            {
              "name": "custom-attribute-definitions",
              "item": [
                {
                  "name": "{key}",
                  "item": [
                    {
                      "name": "Square Delete Booking Custom Attribute Definition",
                      "id": "6cb3cbd6-37d0-48a7-8a38-8b801bb4e0f8",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "auth": {
                          "type": "oauth2",
                          "oauth2": [
                            {
                              "key": "scope",
                              "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE",
                              "type": "string"
                            },
                            {
                              "key": "accessTokenUrl",
                              "value": "https://connect.squareup.com/oauth2/token",
                              "type": "string"
                            },
                            {
                              "key": "authUrl",
                              "value": "https://connect.squareup.com/oauth2/authorize",
                              "type": "string"
                            },
                            {
                              "key": "grant_type",
                              "value": "authorization_code",
                              "type": "string"
                            }
                          ]
                        },
                        "method": "DELETE",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/v2/bookings/custom-attribute-definitions/:key",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "bookings",
                            "custom-attribute-definitions",
                            ":key"
                          ],
                          "variable": [
                            {
                              "id": "cca611b8-8741-4d22-9340-265c199aca71",
                              "key": "key",
                              "value": "<string>",
                              "description": "(Required) The key of the custom attribute definition to delete."
                            }
                          ]
                        },
                        "description": "Deletes a bookings custom attribute definition.\n\nTo call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope.\nTo call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope.\n\nFor calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus*\nor *Appointments Premium*."
                      },
                      "response": [
                        {
                          "id": "e846e60c-28c6-4bac-858e-2b7c5e8efa7e",
                          "name": "Success",
                          "originalRequest": {
                            "method": "DELETE",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/json"
                              },
                              {
                                "description": "Added as a part of security scheme: oauth2",
                                "key": "Authorization",
                                "value": "<token>"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/v2/bookings/custom-attribute-definitions/:key",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "v2",
                                "bookings",
                                "custom-attribute-definitions",
                                ":key"
                              ],
                              "variable": [
                                {
                                  "key": "key"
                                }
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "{\n  \"errors\": [\n    {\n      \"category\": \"INVALID_REQUEST_ERROR\",\n      \"code\": \"ADDRESS_VERIFICATION_FAILURE\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    },\n    {\n      \"category\": \"INVALID_REQUEST_ERROR\",\n      \"code\": \"INVALID_EMAIL_ADDRESS\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    }\n  ]\n}",
                          "createdAt": "2026-07-28T03:01:44.000Z",
                          "updatedAt": "2026-07-28T03:01:44.000Z",
                          "uid": "35240-e846e60c-28c6-4bac-858e-2b7c5e8efa7e"
                        }
                      ],
                      "createdAt": "2026-07-28T03:01:44.000Z",
                      "updatedAt": "2026-07-28T03:01:44.000Z",
                      "uid": "35240-6cb3cbd6-37d0-48a7-8a38-8b801bb4e0f8"
                    },
                    {
                      "name": "Square Retrieve Booking Custom Attribute Definition",
                      "id": "17259da7-8a5c-430b-a3a4-5275cf8b4841",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "auth": {
                          "type": "oauth2",
                          "oauth2": [
                            {
                              "key": "scope",
                              "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE",
                              "type": "string"
                            },
                            {
                              "key": "accessTokenUrl",
                              "value": "https://connect.squareup.com/oauth2/token",
                              "type": "string"
                            },
                            {
                              "key": "authUrl",
                              "value": "https://connect.squareup.com/oauth2/authorize",
                              "type": "string"
                            },
                            {
                              "key": "grant_type",
                              "value": "authorization_code",
                              "type": "string"
                            }
                          ]
                        },
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/v2/bookings/custom-attribute-definitions/:key?version=<integer>",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "bookings",
                            "custom-attribute-definitions",
                            ":key"
                          ],
                          "query": [
                            {
                              "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error.",
                              "key": "version",
                              "value": "<integer>"
                            }
                          ],
                          "variable": [
                            {
                              "id": "9f396a6d-9daa-43f7-bfa3-c4d40efc654e",
                              "key": "key",
                              "value": "<string>",
                              "description": "(Required) The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key."
                            }
                          ]
                        },
                        "description": "Retrieves a bookings custom attribute definition.\n\nTo call this endpoint with buyer-level permissions, set `APPOINTMENTS_READ` for the OAuth scope.\nTo call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for the OAuth scope."
                      },
                      "response": [
                        {
                          "id": "51572f12-71ac-46be-9455-88e55cd6564b",
                          "name": "Success",
                          "originalRequest": {
                            "method": "GET",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/json"
                              },
                              {
                                "description": "Added as a part of security scheme: oauth2",
                                "key": "Authorization",
                                "value": "<token>"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/v2/bookings/custom-attribute-definitions/:key?version=<integer>",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "v2",
                                "bookings",
                                "custom-attribute-definitions",
                                ":key"
                              ],
                              "query": [
                                {
                                  "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error.",
                                  "key": "version",
                                  "value": "<integer>"
                                }
                              ],
                              "variable": [
                                {
                                  "key": "key"
                                }
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "null",
                          "createdAt": "2026-07-28T03:01:44.000Z",
                          "updatedAt": "2026-07-28T03:01:44.000Z",
                          "uid": "35240-51572f12-71ac-46be-9455-88e55cd6564b"
                        }
                      ],
                      "createdAt": "2026-07-28T03:01:44.000Z",
                      "updatedAt": "2026-07-28T03:01:44.000Z",
                      "uid": "35240-17259da7-8a5c-430b-a3a4-5275cf8b4841"
                    },
                    {
                      "name": "Square Update Booking Custom Attribute Definition",
                      "id": "3af921ff-05e0-4e18-be96-75a14741c63b",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "auth": {
                          "type": "oauth2",
                          "oauth2": [
                            {
                              "key": "scope",
                              "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE",
                              "type": "string"
                            },
                            {
                              "key": "accessTokenUrl",
                              "value": "https://connect.squareup.com/oauth2/token",
                              "type": "string"
                            },
                            {
                              "key": "authUrl",
                              "value": "https://connect.squareup.com/oauth2/authorize",
                              "type": "string"
                            },
                            {
                              "key": "grant_type",
                              "value": "authorization_code",
                              "type": "string"
                            }
                          ]
                        },
                        "method": "PUT",
                        "header": [
                          {
                            "key": "Content-Type",
                            "value": "application/json"
                          },
                          {
                            "key": "Accept",
                            "value": "application/json"
                          }
                        ],
                        "body": {
                          "mode": "raw",
                          "raw": "{\n  \"custom_attribute_definition\": {\n    \"key\": \"V2BA_vVQnk5l3iaLCESmG38\",\n    \"schema\": {},\n    \"name\": \"<string>\",\n    \"description\": \"<string>\",\n    \"visibility\": \"VISIBILITY_READ_ONLY\",\n    \"version\": \"<integer>\",\n    \"updated_at\": \"<string>\",\n    \"created_at\": \"<string>\"\n  },\n  \"idempotency_key\": \"<string>\"\n}",
                          "options": {
                            "raw": {
                              "headerFamily": "json",
                              "language": "json"
                            }
                          }
                        },
                        "url": {
                          "raw": "{{baseUrl}}/v2/bookings/custom-attribute-definitions/:key",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "bookings",
                            "custom-attribute-definitions",
                            ":key"
                          ],
                          "variable": [
                            {
                              "id": "61405bf9-b694-4456-8f2f-74a8bd195908",
                              "key": "key",
                              "value": "<string>",
                              "description": "(Required) The key of the custom attribute definition to update."
                            }
                          ]
                        },
                        "description": "Updates a bookings custom attribute definition.\n\nTo call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope.\nTo call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope.\n\nFor calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus*\nor *Appointments Premium*."
                      },
                      "response": [
                        {
                          "id": "07190864-4330-466a-9c8a-1e13a1b25776",
                          "name": "Success",
                          "originalRequest": {
                            "method": "PUT",
                            "header": [
                              {
                                "key": "Content-Type",
                                "value": "application/json"
                              },
                              {
                                "key": "Accept",
                                "value": "application/json"
                              },
                              {
                                "description": "Added as a part of security scheme: oauth2",
                                "key": "Authorization",
                                "value": "<token>"
                              }
                            ],
                            "body": {
                              "mode": "raw",
                              "raw": "{\n  \"custom_attribute_definition\": {\n    \"key\": \"V2BA_vVQnk5l3iaLCESmG38\",\n    \"schema\": {},\n    \"name\": \"<string>\",\n    \"description\": \"<string>\",\n    \"visibility\": \"VISIBILITY_READ_ONLY\",\n    \"version\": \"<integer>\",\n    \"updated_at\": \"<string>\",\n    \"created_at\": \"<string>\"\n  },\n  \"idempotency_key\": \"<string>\"\n}",
                              "options": {
                                "raw": {
                                  "headerFamily": "json",
                                  "language": "json"
                                }
                              }
                            },
                            "url": {
                              "raw": "{{baseUrl}}/v2/bookings/custom-attribute-definitions/:key",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "v2",
                                "bookings",
                                "custom-attribute-definitions",
                                ":key"
                              ],
                              "variable": [
                                {
                                  "key": "key"
                                }
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "null",
                          "createdAt": "2026-07-28T03:01:44.000Z",
                          "updatedAt": "2026-07-28T03:01:44.000Z",
                          "uid": "35240-07190864-4330-466a-9c8a-1e13a1b25776"
                        }
                      ],
                      "createdAt": "2026-07-28T03:01:44.000Z",
                      "updatedAt": "2026-07-28T03:01:44.000Z",
                      "uid": "35240-3af921ff-05e0-4e18-be96-75a14741c63b"
                    }
                  ],
                  "id": "e449ab66-96e1-4f43-b377-25110662f418",
                  "createdAt": "2026-07-28T03:01:44.000Z",
                  "updatedAt": "2026-07-28T03:01:44.000Z",
                  "uid": "35240-e449ab66-96e1-4f43-b377-25110662f418"
                },
                {
                  "name": "Square List Booking Custom Attribute Definitions",
                  "id": "a911b6eb-3a3e-4a81-a8fe-f6af108f8779",
                  "protocolProfileBehavior": {
                    "disableBodyPruning": true
                  },
                  "request": {
                    "auth": {
                      "type": "oauth2",
                      "oauth2": [
                        {
                          "key": "scope",
                          "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE",
                          "type": "string"
                        },
                        {
                          "key": "accessTokenUrl",
                          "value": "https://connect.squareup.com/oauth2/token",
                          "type": "string"
                        },
                        {
                          "key": "authUrl",
                          "value": "https://connect.squareup.com/oauth2/authorize",
                          "type": "string"
                        },
                        {
                          "key": "grant_type",
                          "value": "authorization_code",
                          "type": "string"
                        }
                      ]
                    },
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/v2/bookings/custom-attribute-definitions?limit=<integer>&cursor=<string>",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v2",
                        "bookings",
                        "custom-attribute-definitions"
                      ],
                      "query": [
                        {
                          "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).",
                          "key": "limit",
                          "value": "<integer>"
                        },
                        {
                          "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).",
                          "key": "cursor",
                          "value": "<string>"
                        }
                      ]
                    },
                    "description": "Get all bookings custom attribute definitions.\n\nTo call this endpoint with buyer-level permissions, set `APPOINTMENTS_READ` for the OAuth scope.\nTo call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for the OAuth scope."
                  },
                  "response": [
                    {
                      "id": "8f566ee1-3b67-490d-bdc1-516d2b1fe838",
                      "name": "Success",
                      "originalRequest": {
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          },
                          {
                            "description": "Added as a part of security scheme: oauth2",
                            "key": "Authorization",
                            "value": "<token>"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/v2/bookings/custom-attribute-definitions?limit=<integer>&cursor=<string>",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "bookings",
                            "custom-attribute-definitions"
                          ],
                          "query": [
                            {
                              "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).",
                              "key": "limit",
                              "value": "<integer>"
                            },
                            {
                              "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).",
                              "key": "cursor",
                              "value": "<string>"
                            }
                          ]
                        }
                      },
                      "status": "OK",
                      "code": 200,
                      "_postman_previewlanguage": "json",
                      "header": [
                        {
                          "key": "Content-Type",
                          "value": "application/json"
                        }
                      ],
                      "cookie": [],
                      "responseTime": null,
                      "body": "null",
                      "createdAt": "2026-07-28T03:01:44.000Z",
                      "updatedAt": "2026-07-28T03:01:44.000Z",
                      "uid": "35240-8f566ee1-3b67-490d-bdc1-516d2b1fe838"
                    }
                  ],
                  "createdAt": "2026-07-28T03:01:44.000Z",
                  "updatedAt": "2026-07-28T03:01:44.000Z",
                  "uid": "35240-a911b6eb-3a3e-4a81-a8fe-f6af108f8779"
                },
                {
                  "name": "Square Create Booking Custom Attribute Definition",
                  "id": "8546e86a-2dbf-409f-b4b1-d20924e95523",
                  "protocolProfileBehavior": {
                    "disableBodyPruning": true
                  },
                  "request": {
                    "auth": {
                      "type": "oauth2",
                      "oauth2": [
                        {
                          "key": "scope",
                          "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE",
                          "type": "string"
                        },
                        {
                          "key": "accessTokenUrl",
                          "value": "https://connect.squareup.com/oauth2/token",
                          "type": "string"
                        },
                        {
                          "key": "authUrl",
                          "value": "https://connect.squareup.com/oauth2/authorize",
                          "type": "string"
                        },
                        {
                          "key": "grant_type",
                          "value": "authorization_code",
                          "type": "string"
                        }
                      ]
                    },
                    "method": "POST",
                    "header": [
                      {
                        "key": "Content-Type",
                        "value": "application/json"
                      },
                      {
                        "key": "Accept",
                        "value": "application/json"
                      }
                    ],
                    "body": {
                      "mode": "raw",
                      "raw": "{\n  \"custom_attribute_definition\": {\n    \"key\": \"MbDqNoYIy6QHk9YyZ8nX4nEmz4\",\n    \"schema\": {},\n    \"name\": \"<string>\",\n    \"description\": \"<string>\",\n    \"visibility\": \"VISIBILITY_READ_ONLY\",\n    \"version\": \"<integer>\",\n    \"updated_at\": \"<string>\",\n    \"created_at\": \"<string>\"\n  },\n  \"idempotency_key\": \"<string>\"\n}",
                      "options": {
                        "raw": {
                          "headerFamily": "json",
                          "language": "json"
                        }
                      }
                    },
                    "url": {
                      "raw": "{{baseUrl}}/v2/bookings/custom-attribute-definitions",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v2",
                        "bookings",
                        "custom-attribute-definitions"
                      ]
                    },
                    "description": "Creates a bookings custom attribute definition.\n\nTo call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope.\nTo call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope.\n\nFor calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus*\nor *Appointments Premium*."
                  },
                  "response": [
                    {
                      "id": "2358d5ed-681b-4ea8-9bb3-89f982c43d14",
                      "name": "Success",
                      "originalRequest": {
                        "method": "POST",
                        "header": [
                          {
                            "key": "Content-Type",
                            "value": "application/json"
                          },
                          {
                            "key": "Accept",
                            "value": "application/json"
                          },
                          {
                            "description": "Added as a part of security scheme: oauth2",
                            "key": "Authorization",
                            "value": "<token>"
                          }
                        ],
                        "body": {
                          "mode": "raw",
                          "raw": "{\n  \"custom_attribute_definition\": {\n    \"key\": \"MbDqNoYIy6QHk9YyZ8nX4nEmz4\",\n    \"schema\": {},\n    \"name\": \"<string>\",\n    \"description\": \"<string>\",\n    \"visibility\": \"VISIBILITY_READ_ONLY\",\n    \"version\": \"<integer>\",\n    \"updated_at\": \"<string>\",\n    \"created_at\": \"<string>\"\n  },\n  \"idempotency_key\": \"<string>\"\n}",
                          "options": {
                            "raw": {
                              "headerFamily": "json",
                              "language": "json"
                            }
                          }
                        },
                        "url": {
                          "raw": "{{baseUrl}}/v2/bookings/custom-attribute-definitions",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "bookings",
                            "custom-attribute-definitions"
                          ]
                        }
                      },
                      "status": "OK",
                      "code": 200,
                      "_postman_previewlanguage": "json",
                      "header": [
                        {
                          "key": "Content-Type",
                          "value": "application/json"
                        }
                      ],
                      "cookie": [],
                      "responseTime": null,
                      "body": "null",
                      "createdAt": "2026-07-28T03:01:44.000Z",
                      "updatedAt": "2026-07-28T03:01:44.000Z",
                      "uid": "35240-2358d5ed-681b-4ea8-9bb3-89f982c43d14"
                    }
                  ],
                  "createdAt": "2026-07-28T03:01:44.000Z",
                  "updatedAt": "2026-07-28T03:01:44.000Z",
                  "uid": "35240-8546e86a-2dbf-409f-b4b1-d20924e95523"
                }
              ],
              "id": "30607979-58e4-43a6-94a2-790d1949ea82",
              "createdAt": "2026-07-28T03:01:44.000Z",
              "updatedAt": "2026-07-28T03:01:44.000Z",
              "uid": "35240-30607979-58e4-43a6-94a2-790d1949ea82"
            },
            {
              "name": "custom-attributes",
              "item": [
                {
                  "name": "bulk-delete",
                  "item": [
                    {
                      "name": "Square Bulk Delete Booking Custom Attributes",
                      "id": "e8aac13d-76e2-4904-840f-e22dc3326e3f",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "auth": {
                          "type": "oauth2",
                          "oauth2": [
                            {
                              "key": "scope",
                              "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE",
                              "type": "string"
                            },
                            {
                              "key": "accessTokenUrl",
                              "value": "https://connect.squareup.com/oauth2/token",
                              "type": "string"
                            },
                            {
                              "key": "authUrl",
                              "value": "https://connect.squareup.com/oauth2/authorize",
                              "type": "string"
                            },
                            {
                              "key": "grant_type",
                              "value": "authorization_code",
                              "type": "string"
                            }
                          ]
                        },
                        "method": "POST",
                        "header": [
                          {
                            "key": "Content-Type",
                            "value": "application/json"
                          },
                          {
                            "key": "Accept",
                            "value": "application/json"
                          }
                        ],
                        "body": {
                          "mode": "raw",
                          "raw": "{\n  \"values\": {\n    \"ind\": {\n      \"booking_id\": \"<string>\",\n      \"key\": \"<string>\"\n    },\n    \"ex_c\": {\n      \"booking_id\": \"<string>\",\n      \"key\": \"<string>\"\n    },\n    \"consequatf6\": {\n      \"booking_id\": \"<string>\",\n      \"key\": \"<string>\"\n    },\n    \"ea049\": {\n      \"booking_id\": \"<string>\",\n      \"key\": \"<string>\"\n    }\n  }\n}",
                          "options": {
                            "raw": {
                              "headerFamily": "json",
                              "language": "json"
                            }
                          }
                        },
                        "url": {
                          "raw": "{{baseUrl}}/v2/bookings/custom-attributes/bulk-delete",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "bookings",
                            "custom-attributes",
                            "bulk-delete"
                          ]
                        },
                        "description": "Bulk deletes bookings custom attributes.\n\nTo call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope.\nTo call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope.\n\nFor calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus*\nor *Appointments Premium*."
                      },
                      "response": [
                        {
                          "id": "193fea48-5606-4c56-9c5d-f87f5edfe954",
                          "name": "Success",
                          "originalRequest": {
                            "method": "POST",
                            "header": [
                              {
                                "key": "Content-Type",
                                "value": "application/json"
                              },
                              {
                                "key": "Accept",
                                "value": "application/json"
                              },
                              {
                                "description": "Added as a part of security scheme: oauth2",
                                "key": "Authorization",
                                "value": "<token>"
                              }
                            ],
                            "body": {
                              "mode": "raw",
                              "raw": "{\n  \"values\": {\n    \"ind\": {\n      \"booking_id\": \"<string>\",\n      \"key\": \"<string>\"\n    },\n    \"ex_c\": {\n      \"booking_id\": \"<string>\",\n      \"key\": \"<string>\"\n    },\n    \"consequatf6\": {\n      \"booking_id\": \"<string>\",\n      \"key\": \"<string>\"\n    },\n    \"ea049\": {\n      \"booking_id\": \"<string>\",\n      \"key\": \"<string>\"\n    }\n  }\n}",
                              "options": {
                                "raw": {
                                  "headerFamily": "json",
                                  "language": "json"
                                }
                              }
                            },
                            "url": {
                              "raw": "{{baseUrl}}/v2/bookings/custom-attributes/bulk-delete",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "v2",
                                "bookings",
                                "custom-attributes",
                                "bulk-delete"
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "{\n  \"values\": {\n    \"incididunt_9\": {\n      \"booking_id\": \"<string>\",\n      \"errors\": [\n        {\n          \"category\": \"REFUND_ERROR\",\n          \"code\": \"V1_ACCESS_TOKEN\",\n          \"detail\": \"<string>\",\n          \"field\": \"<string>\"\n        }\n      ]\n    }\n  },\n  \"errors\": [\n    {\n      \"category\": \"REFUND_ERROR\",\n      \"code\": \"INSUFFICIENT_PERMISSIONS_FOR_REFUND\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    }\n  ]\n}",
                          "createdAt": "2026-07-28T03:01:44.000Z",
                          "updatedAt": "2026-07-28T03:01:44.000Z",
                          "uid": "35240-193fea48-5606-4c56-9c5d-f87f5edfe954"
                        }
                      ],
                      "createdAt": "2026-07-28T03:01:44.000Z",
                      "updatedAt": "2026-07-28T03:01:44.000Z",
                      "uid": "35240-e8aac13d-76e2-4904-840f-e22dc3326e3f"
                    }
                  ],
                  "id": "af11e31a-97f3-44b0-ba7d-59b565e61174",
                  "createdAt": "2026-07-28T03:01:44.000Z",
                  "updatedAt": "2026-07-28T03:01:44.000Z",
                  "uid": "35240-af11e31a-97f3-44b0-ba7d-59b565e61174"
                },
                {
                  "name": "bulk-upsert",
                  "item": [
                    {
                      "name": "Square Bulk Upsert Booking Custom Attributes",
                      "id": "a73992d8-011c-4af0-a99c-5a7c71b19023",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "auth": {
                          "type": "oauth2",
                          "oauth2": [
                            {
                              "key": "scope",
                              "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE",
                              "type": "string"
                            },
                            {
                              "key": "accessTokenUrl",
                              "value": "https://connect.squareup.com/oauth2/token",
                              "type": "string"
                            },
                            {
                              "key": "authUrl",
                              "value": "https://connect.squareup.com/oauth2/authorize",
                              "type": "string"
                            },
                            {
                              "key": "grant_type",
                              "value": "authorization_code",
                              "type": "string"
                            }
                          ]
                        },
                        "method": "POST",
                        "header": [
                          {
                            "key": "Content-Type",
                            "value": "application/json"
                          },
                          {
                            "key": "Accept",
                            "value": "application/json"
                          }
                        ],
                        "body": {
                          "mode": "raw",
                          "raw": "{\n  \"values\": {\n    \"dolor_462\": {\n      \"booking_id\": \"<string>\",\n      \"custom_attribute\": {\n        \"key\": \"sqfGuP4EKnAgfA7y941DtwRJHalCO6xzP95ODN2bdvEpypCEC6rylp\",\n        \"value\": {\n          \"description\": \"The value assigned to the custom attribute. It is validated against the custom\\nattribute definition's schema on write operations. For more information about custom\\nattribute values,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\",\n          \"nullable\": true\n        },\n        \"version\": \"<integer>\",\n        \"visibility\": \"VISIBILITY_READ_WRITE_VALUES\",\n        \"definition\": {\n          \"key\": \"n\",\n          \"schema\": {},\n          \"name\": \"<string>\",\n          \"description\": \"<string>\",\n          \"visibility\": \"VISIBILITY_READ_ONLY\",\n          \"version\": \"<integer>\",\n          \"updated_at\": \"<string>\",\n          \"created_at\": \"<string>\"\n        },\n        \"updated_at\": \"<string>\",\n        \"created_at\": \"<string>\"\n      },\n      \"idempotency_key\": \"<string>\"\n    }\n  }\n}",
                          "options": {
                            "raw": {
                              "headerFamily": "json",
                              "language": "json"
                            }
                          }
                        },
                        "url": {
                          "raw": "{{baseUrl}}/v2/bookings/custom-attributes/bulk-upsert",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "bookings",
                            "custom-attributes",
                            "bulk-upsert"
                          ]
                        },
                        "description": "Bulk upserts bookings custom attributes.\n\nTo call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope.\nTo call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope.\n\nFor calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus*\nor *Appointments Premium*."
                      },
                      "response": [
                        {
                          "id": "1de1492d-996b-4c06-8965-ebc501d80ae1",
                          "name": "Success",
                          "originalRequest": {
                            "method": "POST",
                            "header": [
                              {
                                "key": "Content-Type",
                                "value": "application/json"
                              },
                              {
                                "key": "Accept",
                                "value": "application/json"
                              },
                              {
                                "description": "Added as a part of security scheme: oauth2",
                                "key": "Authorization",
                                "value": "<token>"
                              }
                            ],
                            "body": {
                              "mode": "raw",
                              "raw": "{\n  \"values\": {\n    \"dolor_462\": {\n      \"booking_id\": \"<string>\",\n      \"custom_attribute\": {\n        \"key\": \"sqfGuP4EKnAgfA7y941DtwRJHalCO6xzP95ODN2bdvEpypCEC6rylp\",\n        \"value\": {\n          \"description\": \"The value assigned to the custom attribute. It is validated against the custom\\nattribute definition's schema on write operations. For more information about custom\\nattribute values,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\",\n          \"nullable\": true\n        },\n        \"version\": \"<integer>\",\n        \"visibility\": \"VISIBILITY_READ_WRITE_VALUES\",\n        \"definition\": {\n          \"key\": \"n\",\n          \"schema\": {},\n          \"name\": \"<string>\",\n          \"description\": \"<string>\",\n          \"visibility\": \"VISIBILITY_READ_ONLY\",\n          \"version\": \"<integer>\",\n          \"updated_at\": \"<string>\",\n          \"created_at\": \"<string>\"\n        },\n        \"updated_at\": \"<string>\",\n        \"created_at\": \"<string>\"\n      },\n      \"idempotency_key\": \"<string>\"\n    }\n  }\n}",
                              "options": {
                                "raw": {
                                  "headerFamily": "json",
                                  "language": "json"
                                }
                              }
                            },
                            "url": {
                              "raw": "{{baseUrl}}/v2/bookings/custom-attributes/bulk-upsert",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "v2",
                                "bookings",
                                "custom-attributes",
                                "bulk-upsert"
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "{\n  \"values\": {\n    \"aute_b\": {\n      \"booking_id\": \"<string>\",\n      \"custom_attribute\": {\n        \"key\": \"HvKldQyM:vimxYajUMvPsX\",\n        \"value\": {\n          \"description\": \"The value assigned to the custom attribute. It is validated against the custom\\nattribute definition's schema on write operations. For more information about custom\\nattribute values,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\",\n          \"nullable\": true\n        },\n        \"version\": \"<integer>\",\n        \"visibility\": \"VISIBILITY_HIDDEN\",\n        \"definition\": {\n          \"key\": \"BKZa-VO6Tq:JYmWBd0mBlcLuffMC\",\n          \"schema\": {},\n          \"name\": \"<string>\",\n          \"description\": \"<string>\",\n          \"visibility\": \"VISIBILITY_HIDDEN\",\n          \"version\": \"<integer>\",\n          \"updated_at\": \"<string>\",\n          \"created_at\": \"<string>\"\n        },\n        \"updated_at\": \"<string>\",\n        \"created_at\": \"<string>\"\n      },\n      \"errors\": [\n        {\n          \"category\": \"INVALID_REQUEST_ERROR\",\n          \"code\": \"INVALID_ENUM_VALUE\",\n          \"detail\": \"<string>\",\n          \"field\": \"<string>\"\n        }\n      ]\n    }\n  },\n  \"errors\": [\n    {\n      \"category\": \"EXTERNAL_VENDOR_ERROR\",\n      \"code\": \"PLAID_ERROR_ITEM_LOGIN_REQUIRED\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    }\n  ]\n}",
                          "createdAt": "2026-07-28T03:01:44.000Z",
                          "updatedAt": "2026-07-28T03:01:44.000Z",
                          "uid": "35240-1de1492d-996b-4c06-8965-ebc501d80ae1"
                        }
                      ],
                      "createdAt": "2026-07-28T03:01:44.000Z",
                      "updatedAt": "2026-07-28T03:01:44.000Z",
                      "uid": "35240-a73992d8-011c-4af0-a99c-5a7c71b19023"
                    }
                  ],
                  "id": "7f1daa87-205a-4cb0-940f-a4fa93d9e819",
                  "createdAt": "2026-07-28T03:01:44.000Z",
                  "updatedAt": "2026-07-28T03:01:44.000Z",
                  "uid": "35240-7f1daa87-205a-4cb0-940f-a4fa93d9e819"
                }
              ],
              "id": "12f7a6a1-14c8-4e54-8c2f-6e0ef9a2cd18",
              "createdAt": "2026-07-28T03:01:44.000Z",
              "updatedAt": "2026-07-28T03:01:44.000Z",
              "uid": "35240-12f7a6a1-14c8-4e54-8c2f-6e0ef9a2cd18"
            },
            {
              "name": "{booking_id}",
              "item": [
                {
                  "name": "custom-attributes",
                  "item": [
                    {
                      "name": "{key}",
                      "item": [
                        {
                          "name": "Square Delete Booking Custom Attribute",
                          "id": "012ea835-37ed-41b7-b22b-8687e5073e67",
                          "protocolProfileBehavior": {
                            "disableBodyPruning": true
                          },
                          "request": {
                            "auth": {
                              "type": "oauth2",
                              "oauth2": [
                                {
                                  "key": "scope",
                                  "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE",
                                  "type": "string"
                                },
                                {
                                  "key": "accessTokenUrl",
                                  "value": "https://connect.squareup.com/oauth2/token",
                                  "type": "string"
                                },
                                {
                                  "key": "authUrl",
                                  "value": "https://connect.squareup.com/oauth2/authorize",
                                  "type": "string"
                                },
                                {
                                  "key": "grant_type",
                                  "value": "authorization_code",
                                  "type": "string"
                                }
                              ]
                            },
                            "method": "DELETE",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/json"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/v2/bookings/:booking_id/custom-attributes/:key",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "v2",
                                "bookings",
                                ":booking_id",
                                "custom-attributes",
                                ":key"
                              ],
                              "variable": [
                                {
                                  "id": "e77b8220-4ab4-4f54-9f0f-c2a7a8e08bf6",
                                  "key": "booking_id",
                                  "value": "<string>",
                                  "description": "(Required) The ID of the target [booking](entity:Booking)."
                                },
                                {
                                  "id": "c84a6a16-5451-4d69-92b5-2ae226e2265a",
                                  "key": "key",
                                  "value": "<string>",
                                  "description": "(Required) The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key."
                                }
                              ]
                            },
                            "description": "Deletes a bookings custom attribute.\n\nTo call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope.\nTo call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope.\n\nFor calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus*\nor *Appointments Premium*."
                          },
                          "response": [
                            {
                              "id": "b46d9669-945d-4719-a402-a6ae8284a040",
                              "name": "Success",
                              "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                  {
                                    "key": "Accept",
                                    "value": "application/json"
                                  },
                                  {
                                    "description": "Added as a part of security scheme: oauth2",
                                    "key": "Authorization",
                                    "value": "<token>"
                                  }
                                ],
                                "url": {
                                  "raw": "{{baseUrl}}/v2/bookings/:booking_id/custom-attributes/:key",
                                  "host": [
                                    "{{baseUrl}}"
                                  ],
                                  "path": [
                                    "v2",
                                    "bookings",
                                    ":booking_id",
                                    "custom-attributes",
                                    ":key"
                                  ],
                                  "variable": [
                                    {
                                      "key": "booking_id"
                                    },
                                    {
                                      "key": "key"
                                    }
                                  ]
                                }
                              },
                              "status": "OK",
                              "code": 200,
                              "_postman_previewlanguage": "json",
                              "header": [
                                {
                                  "key": "Content-Type",
                                  "value": "application/json"
                                }
                              ],
                              "cookie": [],
                              "responseTime": null,
                              "body": "{\n  \"errors\": [\n    {\n      \"category\": \"EXTERNAL_VENDOR_ERROR\",\n      \"code\": \"INTERNAL_SERVER_ERROR\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    },\n    {\n      \"category\": \"EXTERNAL_VENDOR_ERROR\",\n      \"code\": \"INVALID_CURSOR\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    }\n  ]\n}",
                              "createdAt": "2026-07-28T03:01:44.000Z",
                              "updatedAt": "2026-07-28T03:01:44.000Z",
                              "uid": "35240-b46d9669-945d-4719-a402-a6ae8284a040"
                            }
                          ],
                          "createdAt": "2026-07-28T03:01:44.000Z",
                          "updatedAt": "2026-07-28T03:01:44.000Z",
                          "uid": "35240-012ea835-37ed-41b7-b22b-8687e5073e67"
                        },
                        {
                          "name": "Square Retrieve Booking Custom Attribute",
                          "id": "2198ab93-0dc8-4c97-8d2f-24b33e58927d",
                          "protocolProfileBehavior": {
                            "disableBodyPruning": true
                          },
                          "request": {
                            "auth": {
                              "type": "oauth2",
                              "oauth2": [
                                {
                                  "key": "scope",
                                  "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE",
                                  "type": "string"
                                },
                                {
                                  "key": "accessTokenUrl",
                                  "value": "https://connect.squareup.com/oauth2/token",
                                  "type": "string"
                                },
                                {
                                  "key": "authUrl",
                                  "value": "https://connect.squareup.com/oauth2/authorize",
                                  "type": "string"
                                },
                                {
                                  "key": "grant_type",
                                  "value": "authorization_code",
                                  "type": "string"
                                }
                              ]
                            },
                            "method": "GET",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/json"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/v2/bookings/:booking_id/custom-attributes/:key?with_definition=false&version=<integer>",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "v2",
                                "bookings",
                                ":booking_id",
                                "custom-attributes",
                                ":key"
                              ],
                              "query": [
                                {
                                  "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`.",
                                  "key": "with_definition",
                                  "value": "false"
                                },
                                {
                                  "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error.",
                                  "key": "version",
                                  "value": "<integer>"
                                }
                              ],
                              "variable": [
                                {
                                  "id": "a273ffad-5537-4555-a81b-18740df7b1d1",
                                  "key": "booking_id",
                                  "value": "<string>",
                                  "description": "(Required) The ID of the target [booking](entity:Booking)."
                                },
                                {
                                  "id": "304e0e66-5f4c-4bfa-8fcc-6c716f9783bd",
                                  "key": "key",
                                  "value": "<string>",
                                  "description": "(Required) The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key."
                                }
                              ]
                            },
                            "description": "Retrieves a bookings custom attribute.\n\nTo call this endpoint with buyer-level permissions, set `APPOINTMENTS_READ` for the OAuth scope.\nTo call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for the OAuth scope."
                          },
                          "response": [
                            {
                              "id": "c04c46e9-480b-49ba-8d7d-12e5e7ff0dd6",
                              "name": "Success",
                              "originalRequest": {
                                "method": "GET",
                                "header": [
                                  {
                                    "key": "Accept",
                                    "value": "application/json"
                                  },
                                  {
                                    "description": "Added as a part of security scheme: oauth2",
                                    "key": "Authorization",
                                    "value": "<token>"
                                  }
                                ],
                                "url": {
                                  "raw": "{{baseUrl}}/v2/bookings/:booking_id/custom-attributes/:key?with_definition=false&version=<integer>",
                                  "host": [
                                    "{{baseUrl}}"
                                  ],
                                  "path": [
                                    "v2",
                                    "bookings",
                                    ":booking_id",
                                    "custom-attributes",
                                    ":key"
                                  ],
                                  "query": [
                                    {
                                      "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`.",
                                      "key": "with_definition",
                                      "value": "false"
                                    },
                                    {
                                      "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error.",
                                      "key": "version",
                                      "value": "<integer>"
                                    }
                                  ],
                                  "variable": [
                                    {
                                      "key": "booking_id"
                                    },
                                    {
                                      "key": "key"
                                    }
                                  ]
                                }
                              },
                              "status": "OK",
                              "code": 200,
                              "_postman_previewlanguage": "json",
                              "header": [
                                {
                                  "key": "Content-Type",
                                  "value": "application/json"
                                }
                              ],
                              "cookie": [],
                              "responseTime": null,
                              "body": "{\n  \"custom_attribute\": {\n    \"key\": \".R-:ecpQQDQVLz0.zJhj7pDI7FF3_5F30sefiB0ZMl3Hr0cRwTdqkDF\",\n    \"value\": {\n      \"description\": \"The value assigned to the custom attribute. It is validated against the custom\\nattribute definition's schema on write operations. For more information about custom\\nattribute values,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\",\n      \"nullable\": true\n    },\n    \"version\": \"<integer>\",\n    \"visibility\": \"VISIBILITY_READ_ONLY\",\n    \"definition\": {\n      \"key\": \"lE6J_:ZEFZWgmyZp19SmP_ddHyxU-oBeRDKxL0\",\n      \"schema\": {},\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"visibility\": \"VISIBILITY_HIDDEN\",\n      \"version\": \"<integer>\",\n      \"updated_at\": \"<string>\",\n      \"created_at\": \"<string>\"\n    },\n    \"updated_at\": \"<string>\",\n    \"created_at\": \"<string>\"\n  },\n  \"errors\": [\n    {\n      \"category\": \"PAYMENT_METHOD_ERROR\",\n      \"code\": \"UNSUPPORTED_INSTRUMENT_TYPE\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    },\n    {\n      \"category\": \"INVALID_REQUEST_ERROR\",\n      \"code\": \"APPLICATION_DISABLED\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    }\n  ]\n}",
                              "createdAt": "2026-07-28T03:01:44.000Z",
                              "updatedAt": "2026-07-28T03:01:44.000Z",
                              "uid": "35240-c04c46e9-480b-49ba-8d7d-12e5e7ff0dd6"
                            }
                          ],
                          "createdAt": "2026-07-28T03:01:44.000Z",
                          "updatedAt": "2026-07-28T03:01:44.000Z",
                          "uid": "35240-2198ab93-0dc8-4c97-8d2f-24b33e58927d"
                        },
                        {
                          "name": "Square Upsert Booking Custom Attribute",
                          "id": "0dc4d5d0-3b40-4d7f-8dfa-c6cb01020a10",
                          "protocolProfileBehavior": {
                            "disableBodyPruning": true
                          },
                          "request": {
                            "auth": {
                              "type": "oauth2",
                              "oauth2": [
                                {
                                  "key": "scope",
                                  "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE",
                                  "type": "string"
                                },
                                {
                                  "key": "accessTokenUrl",
                                  "value": "https://connect.squareup.com/oauth2/token",
                                  "type": "string"
                                },
                                {
                                  "key": "authUrl",
                                  "value": "https://connect.squareup.com/oauth2/authorize",
                                  "type": "string"
                                },
                                {
                                  "key": "grant_type",
                                  "value": "authorization_code",
                                  "type": "string"
                                }
                              ]
                            },
                            "method": "PUT",
                            "header": [
                              {
                                "key": "Content-Type",
                                "value": "application/json"
                              },
                              {
                                "key": "Accept",
                                "value": "application/json"
                              }
                            ],
                            "body": {
                              "mode": "raw",
                              "raw": "{\n  \"custom_attribute\": {\n    \"key\": \"QAleAs:HzhHoXaqAFJA0ktkHeJZBkm-QNg2EpH7kiO8CTZTHaipLeQGIEGqHchf\",\n    \"value\": {\n      \"description\": \"The value assigned to the custom attribute. It is validated against the custom\\nattribute definition's schema on write operations. For more information about custom\\nattribute values,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\",\n      \"nullable\": true\n    },\n    \"version\": \"<integer>\",\n    \"visibility\": \"VISIBILITY_HIDDEN\",\n    \"definition\": {\n      \"key\": \"5oGH266HywN0fE8UkTH0a38A52Zw3oLfur_u\",\n      \"schema\": {},\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"visibility\": \"VISIBILITY_READ_WRITE_VALUES\",\n      \"version\": \"<integer>\",\n      \"updated_at\": \"<string>\",\n      \"created_at\": \"<string>\"\n    },\n    \"updated_at\": \"<string>\",\n    \"created_at\": \"<string>\"\n  },\n  \"idempotency_key\": \"<string>\"\n}",
                              "options": {
                                "raw": {
                                  "headerFamily": "json",
                                  "language": "json"
                                }
                              }
                            },
                            "url": {
                              "raw": "{{baseUrl}}/v2/bookings/:booking_id/custom-attributes/:key",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "v2",
                                "bookings",
                                ":booking_id",
                                "custom-attributes",
                                ":key"
                              ],
                              "variable": [
                                {
                                  "id": "3ab9de10-5875-4600-9c42-75156b41ad1b",
                                  "key": "booking_id",
                                  "value": "<string>",
                                  "description": "(Required) The ID of the target [booking](entity:Booking)."
                                },
                                {
                                  "id": "0cc08a31-fadc-4808-bcf1-824ba73139fa",
                                  "key": "key",
                                  "value": "<string>",
                                  "description": "(Required) The key of the custom attribute to create or update. This key must match the `key` of a\ncustom attribute definition in the Square seller account. If the requesting application is not\nthe definition owner, you must use the qualified key."
                                }
                              ]
                            },
                            "description": "Upserts a bookings custom attribute.\n\nTo call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope.\nTo call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope.\n\nFor calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus*\nor *Appointments Premium*."
                          },
                          "response": [
                            {
                              "id": "c8413ea4-6775-4bf7-9a46-5ae0b845d862",
                              "name": "Success",
                              "originalRequest": {
                                "method": "PUT",
                                "header": [
                                  {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                  },
                                  {
                                    "key": "Accept",
                                    "value": "application/json"
                                  },
                                  {
                                    "description": "Added as a part of security scheme: oauth2",
                                    "key": "Authorization",
                                    "value": "<token>"
                                  }
                                ],
                                "body": {
                                  "mode": "raw",
                                  "raw": "{\n  \"custom_attribute\": {\n    \"key\": \"QAleAs:HzhHoXaqAFJA0ktkHeJZBkm-QNg2EpH7kiO8CTZTHaipLeQGIEGqHchf\",\n    \"value\": {\n      \"description\": \"The value assigned to the custom attribute. It is validated against the custom\\nattribute definition's schema on write operations. For more information about custom\\nattribute values,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\",\n      \"nullable\": true\n    },\n    \"version\": \"<integer>\",\n    \"visibility\": \"VISIBILITY_HIDDEN\",\n    \"definition\": {\n      \"key\": \"5oGH266HywN0fE8UkTH0a38A52Zw3oLfur_u\",\n      \"schema\": {},\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"visibility\": \"VISIBILITY_READ_WRITE_VALUES\",\n      \"version\": \"<integer>\",\n      \"updated_at\": \"<string>\",\n      \"created_at\": \"<string>\"\n    },\n    \"updated_at\": \"<string>\",\n    \"created_at\": \"<string>\"\n  },\n  \"idempotency_key\": \"<string>\"\n}",
                                  "options": {
                                    "raw": {
                                      "headerFamily": "json",
                                      "language": "json"
                                    }
                                  }
                                },
                                "url": {
                                  "raw": "{{baseUrl}}/v2/bookings/:booking_id/custom-attributes/:key",
                                  "host": [
                                    "{{baseUrl}}"
                                  ],
                                  "path": [
                                    "v2",
                                    "bookings",
                                    ":booking_id",
                                    "custom-attributes",
                                    ":key"
                                  ],
                                  "variable": [
                                    {
                                      "key": "booking_id"
                                    },
                                    {
                                      "key": "key"
                                    }
                                  ]
                                }
                              },
                              "status": "OK",
                              "code": 200,
                              "_postman_previewlanguage": "json",
                              "header": [
                                {
                                  "key": "Content-Type",
                                  "value": "application/json"
                                }
                              ],
                              "cookie": [],
                              "responseTime": null,
                              "body": "{\n  \"custom_attribute\": {\n    \"key\": \"driQHF1V2:CdtU4ozdx8qaQb1BQYelELtWifEF4AON.aI9gm.d7NidHmVBj-85vtB2_l\",\n    \"value\": {\n      \"description\": \"The value assigned to the custom attribute. It is validated against the custom\\nattribute definition's schema on write operations. For more information about custom\\nattribute values,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\",\n      \"nullable\": true\n    },\n    \"version\": \"<integer>\",\n    \"visibility\": \"VISIBILITY_READ_WRITE_VALUES\",\n    \"definition\": {\n      \"key\": \"494QIcOc:ZgMZNbHxG06WiAJhIfkxbN4_OzWAW-_zUNt9krElE\",\n      \"schema\": {},\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"visibility\": \"VISIBILITY_READ_WRITE_VALUES\",\n      \"version\": \"<integer>\",\n      \"updated_at\": \"<string>\",\n      \"created_at\": \"<string>\"\n    },\n    \"updated_at\": \"<string>\",\n    \"created_at\": \"<string>\"\n  },\n  \"errors\": [\n    {\n      \"category\": \"PAYMENT_METHOD_ERROR\",\n      \"code\": \"BAD_EXPIRATION\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    },\n    {\n      \"category\": \"REFUND_ERROR\",\n      \"code\": \"INVALID_ARRAY_VALUE\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    }\n  ]\n}",
                              "createdAt": "2026-07-28T03:01:44.000Z",
                              "updatedAt": "2026-07-28T03:01:44.000Z",
                              "uid": "35240-c8413ea4-6775-4bf7-9a46-5ae0b845d862"
                            }
                          ],
                          "createdAt": "2026-07-28T03:01:44.000Z",
                          "updatedAt": "2026-07-28T03:01:44.000Z",
                          "uid": "35240-0dc4d5d0-3b40-4d7f-8dfa-c6cb01020a10"
                        }
                      ],
                      "id": "8bbfed23-498b-4167-b1a8-91fed384fa5c",
                      "createdAt": "2026-07-28T03:01:44.000Z",
                      "updatedAt": "2026-07-28T03:01:44.000Z",
                      "uid": "35240-8bbfed23-498b-4167-b1a8-91fed384fa5c"
                    },
                    {
                      "name": "Square List Booking Custom Attributes",
                      "id": "d7f4122a-b0c6-46fe-b92d-7d49290f8b08",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "auth": {
                          "type": "oauth2",
                          "oauth2": [
                            {
                              "key": "scope",
                              "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE",
                              "type": "string"
                            },
                            {
                              "key": "accessTokenUrl",
                              "value": "https://connect.squareup.com/oauth2/token",
                              "type": "string"
                            },
                            {
                              "key": "authUrl",
                              "value": "https://connect.squareup.com/oauth2/authorize",
                              "type": "string"
                            },
                            {
                              "key": "grant_type",
                              "value": "authorization_code",
                              "type": "string"
                            }
                          ]
                        },
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/v2/bookings/:booking_id/custom-attributes?limit=<integer>&cursor=<string>&with_definitions=false",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "bookings",
                            ":booking_id",
                            "custom-attributes"
                          ],
                          "query": [
                            {
                              "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).",
                              "key": "limit",
                              "value": "<integer>"
                            },
                            {
                              "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).",
                              "key": "cursor",
                              "value": "<string>"
                            },
                            {
                              "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`.",
                              "key": "with_definitions",
                              "value": "false"
                            }
                          ],
                          "variable": [
                            {
                              "id": "ee9d4140-e316-469b-ba07-5b6f0257e158",
                              "key": "booking_id",
                              "value": "<string>",
                              "description": "(Required) The ID of the target [booking](entity:Booking)."
                            }
                          ]
                        },
                        "description": "Lists a booking's custom attributes.\n\nTo call this endpoint with buyer-level permissions, set `APPOINTMENTS_READ` for the OAuth scope.\nTo call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for the OAuth scope."
                      },
                      "response": [
                        {
                          "id": "8ed942f4-a8ba-4b01-bd4e-ab9d22ede809",
                          "name": "Success",
                          "originalRequest": {
                            "method": "GET",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/json"
                              },
                              {
                                "description": "Added as a part of security scheme: oauth2",
                                "key": "Authorization",
                                "value": "<token>"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/v2/bookings/:booking_id/custom-attributes?limit=<integer>&cursor=<string>&with_definitions=false",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "v2",
                                "bookings",
                                ":booking_id",
                                "custom-attributes"
                              ],
                              "query": [
                                {
                                  "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).",
                                  "key": "limit",
                                  "value": "<integer>"
                                },
                                {
                                  "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).",
                                  "key": "cursor",
                                  "value": "<string>"
                                },
                                {
                                  "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`.",
                                  "key": "with_definitions",
                                  "value": "false"
                                }
                              ],
                              "variable": [
                                {
                                  "key": "booking_id"
                                }
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "{\n  \"custom_attributes\": [\n    {\n      \"key\": \"P\",\n      \"value\": {\n        \"description\": \"The value assigned to the custom attribute. It is validated against the custom\\nattribute definition's schema on write operations. For more information about custom\\nattribute values,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\",\n        \"nullable\": true\n      },\n      \"version\": \"<integer>\",\n      \"visibility\": \"VISIBILITY_HIDDEN\",\n      \"definition\": {\n        \"key\": \"HCdip6MPy\",\n        \"schema\": {},\n        \"name\": \"<string>\",\n        \"description\": \"<string>\",\n        \"visibility\": \"VISIBILITY_HIDDEN\",\n        \"version\": \"<integer>\",\n        \"updated_at\": \"<string>\",\n        \"created_at\": \"<string>\"\n      },\n      \"updated_at\": \"<string>\",\n      \"created_at\": \"<string>\"\n    },\n    {\n      \"key\": \"d8Yw6UWbnpXdizpKHpS0UCRPE_BwGQ6F6L1kwAswrf2_vvhjg\",\n      \"value\": {\n        \"description\": \"The value assigned to the custom attribute. It is validated against the custom\\nattribute definition's schema on write operations. For more information about custom\\nattribute values,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\",\n        \"nullable\": true\n      },\n      \"version\": \"<integer>\",\n      \"visibility\": \"VISIBILITY_HIDDEN\",\n      \"definition\": {\n        \"key\": \"y2H1l:hwZD5TRUr53ro8IOgXHXfLJ72HdzX.H95lxxGNh7gaFce-Cb47y1Wg\",\n        \"schema\": {},\n        \"name\": \"<string>\",\n        \"description\": \"<string>\",\n        \"visibility\": \"VISIBILITY_READ_WRITE_VALUES\",\n        \"version\": \"<integer>\",\n        \"updated_at\": \"<string>\",\n        \"created_at\": \"<string>\"\n      },\n      \"updated_at\": \"<string>\",\n      \"created_at\": \"<string>\"\n    }\n  ],\n  \"cursor\": \"<string>\",\n  \"errors\": [\n    {\n      \"category\": \"API_ERROR\",\n      \"code\": \"PAYMENT_NOT_REFUNDABLE\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    },\n    {\n      \"category\": \"API_ERROR\",\n      \"code\": \"UNPROCESSABLE_ENTITY\",\n      \"detail\": \"<string>\",\n      \"field\": \"<string>\"\n    }\n  ]\n}",
                          "createdAt": "2026-07-28T03:01:44.000Z",
                          "updatedAt": "2026-07-28T03:01:44.000Z",
                          "uid": "35240-8ed942f4-a8ba-4b01-bd4e-ab9d22ede809"
                        }
                      ],
                      "createdAt": "2026-07-28T03:01:44.000Z",
                      "updatedAt": "2026-07-28T03:01:44.000Z",
                      "uid": "35240-d7f4122a-b0c6-46fe-b92d-7d49290f8b08"
                    }
                  ],
                  "id": "61881eef-0e46-4f0b-be96-86d84bbdb01a",
                  "createdAt": "2026-07-28T03:01:44.000Z",
                  "updatedAt": "2026-07-28T03:01:44.000Z",
                  "uid": "35240-61881eef-0e46-4f0b-be96-86d84bbdb01a"
                }
              ],
              "id": "56cf1068-89bf-4ad8-b1d2-f1db876f1476",
              "createdAt": "2026-07-28T03:01:44.000Z",
              "updatedAt": "2026-07-28T03:01:44.000Z",
              "uid": "35240-56cf1068-89bf-4ad8-b1d2-f1db876f1476"
            }
          ],
          "id": "e5fec822-2cd6-4918-b4c7-95bb74758462",
          "createdAt": "2026-07-28T03:01:44.000Z",
          "updatedAt": "2026-07-28T03:01:44.000Z",
          "uid": "35240-e5fec822-2cd6-4918-b4c7-95bb74758462"
        }
      ],
      "id": "50643b7c-3199-46f1-956c-3e4123526330",
      "createdAt": "2026-07-28T03:01:44.000Z",
      "updatedAt": "2026-07-28T03:01:44.000Z",
      "uid": "35240-50643b7c-3199-46f1-956c-3e4123526330"
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://connect.squareup.com"
    }
  ]
}