{ "info": { "_postman_id": "2c374af1-e4c3-4d5b-9c73-9f527ec5e277", "name": "Square ApplePay Bookings 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:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "lastUpdatedBy": "35240", "uid": "35240-2c374af1-e4c3-4d5b-9c73-9f527ec5e277" }, "item": [ { "name": "v2", "item": [ { "name": "bookings", "item": [ { "name": "availability", "item": [ { "name": "search", "item": [ { "name": "Square Search Availability", "id": "30a1727c-8c33-4260-91f0-7801df3c17f4", "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 \"query\": {\n \"filter\": {\n \"start_at_range\": {\n \"start_at\": \"\",\n \"end_at\": \"\"\n },\n \"location_id\": \"\",\n \"segment_filters\": [\n {\n \"service_variation_id\": \"\",\n \"team_member_id_filter\": {\n \"all\": [\n \"\",\n \"\"\n ],\n \"any\": [\n \"\",\n \"\"\n ],\n \"none\": [\n \"\",\n \"\"\n ]\n }\n },\n {\n \"service_variation_id\": \"\",\n \"team_member_id_filter\": {\n \"all\": [\n \"\",\n \"\"\n ],\n \"any\": [\n \"\",\n \"\"\n ],\n \"none\": [\n \"\",\n \"\"\n ]\n }\n }\n ],\n \"booking_id\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings/availability/search", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "availability", "search" ] }, "description": "Searches for availabilities for booking.\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": "818d82c2-1b89-4929-91fa-099960e43b7b", "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": "" } ], "body": { "mode": "raw", "raw": "{\n \"query\": {\n \"filter\": {\n \"start_at_range\": {\n \"start_at\": \"\",\n \"end_at\": \"\"\n },\n \"location_id\": \"\",\n \"segment_filters\": [\n {\n \"service_variation_id\": \"\",\n \"team_member_id_filter\": {\n \"all\": [\n \"\",\n \"\"\n ],\n \"any\": [\n \"\",\n \"\"\n ],\n \"none\": [\n \"\",\n \"\"\n ]\n }\n },\n {\n \"service_variation_id\": \"\",\n \"team_member_id_filter\": {\n \"all\": [\n \"\",\n \"\"\n ],\n \"any\": [\n \"\",\n \"\"\n ],\n \"none\": [\n \"\",\n \"\"\n ]\n }\n }\n ],\n \"booking_id\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings/availability/search", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "availability", "search" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"availabilities\": [\n {\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n }\n ]\n },\n {\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n ],\n \"errors\": [\n {\n \"category\": \"AUTHENTICATION_ERROR\",\n \"code\": \"INVALID_DATE\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"RATE_LIMIT_ERROR\",\n \"code\": \"INSUFFICIENT_PERMISSIONS\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-818d82c2-1b89-4929-91fa-099960e43b7b" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-30a1727c-8c33-4260-91f0-7801df3c17f4" } ], "id": "972b6954-e960-48cf-ab92-746dfedc66e4", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-972b6954-e960-48cf-ab92-746dfedc66e4" } ], "id": "d8d733c4-9a9d-4121-915e-0e817b15052b", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-d8d733c4-9a9d-4121-915e-0e817b15052b" }, { "name": "bulk-retrieve", "item": [ { "name": "Square Bulk Retrieve Bookings", "id": "c6d19955-9276-44bf-a95b-d47275dc1747", "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 \"booking_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings/bulk-retrieve", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "bulk-retrieve" ] }, "description": "Bulk-Retrieves a list of bookings by booking IDs.\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": "9f9fe6e0-8a14-4f83-bcb7-d7fa42b7cff1", "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": "" } ], "body": { "mode": "raw", "raw": "{\n \"booking_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings/bulk-retrieve", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "bulk-retrieve" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"bookings\": {\n \"aute_8\": {\n \"booking\": {\n \"id\": \"\",\n \"version\": \"\",\n \"status\": \"NO_SHOW\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"customer_id\": \"\",\n \"customer_note\": \"\",\n \"seller_note\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\"\n ]\n }\n ],\n \"transition_time_minutes\": \"\",\n \"all_day\": \"\",\n \"location_type\": \"BUSINESS_LOCATION\",\n \"creator_details\": {\n \"creator_type\": \"CUSTOMER\",\n \"team_member_id\": \"\",\n \"customer_id\": \"\"\n },\n \"source\": \"FIRST_PARTY_BUYER\",\n \"address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"NG\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n }\n },\n \"errors\": [\n {\n \"category\": \"AUTHENTICATION_ERROR\",\n \"code\": \"REFUND_DECLINED\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n },\n \"labore_26\": {\n \"booking\": {\n \"id\": \"\",\n \"version\": \"\",\n \"status\": \"PENDING\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"customer_id\": \"\",\n \"customer_note\": \"\",\n \"seller_note\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\"\n ]\n }\n ],\n \"transition_time_minutes\": \"\",\n \"all_day\": \"\",\n \"location_type\": \"PHONE\",\n \"creator_details\": {\n \"creator_type\": \"TEAM_MEMBER\",\n \"team_member_id\": \"\",\n \"customer_id\": \"\"\n },\n \"source\": \"THIRD_PARTY_BUYER\",\n \"address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"CL\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n }\n },\n \"errors\": [\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"INCORRECT_TYPE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n }\n },\n \"errors\": [\n {\n \"category\": \"PAYMENT_METHOD_ERROR\",\n \"code\": \"INVALID_CARD\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-9f9fe6e0-8a14-4f83-bcb7-d7fa42b7cff1" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-c6d19955-9276-44bf-a95b-d47275dc1747" } ], "id": "20334061-b393-4a45-b331-278bf904aa42", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-20334061-b393-4a45-b331-278bf904aa42" }, { "name": "business-booking-profile", "item": [ { "name": "Square Retrieve Business Booking Profile", "id": "4cf8dc51-dcc5-420c-a595-a8b652dec572", "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/business-booking-profile", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "business-booking-profile" ] }, "description": "Retrieves a seller's booking profile." }, "response": [ { "id": "5b4e1bbc-05cc-497f-880e-15ccfd931552", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/bookings/business-booking-profile", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "business-booking-profile" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"business_booking_profile\": {\n \"seller_id\": \"\",\n \"created_at\": \"\",\n \"booking_enabled\": \"\",\n \"customer_timezone_choice\": \"BUSINESS_LOCATION_TIMEZONE\",\n \"booking_policy\": \"ACCEPT_ALL\",\n \"allow_user_cancel\": \"\",\n \"business_appointment_settings\": {\n \"location_types\": [\n \"PHONE\",\n \"PHONE\"\n ],\n \"alignment_time\": \"HOURLY\",\n \"min_booking_lead_time_seconds\": \"\",\n \"max_booking_lead_time_seconds\": \"\",\n \"any_team_member_booking_enabled\": \"\",\n \"multiple_service_booking_enabled\": \"\",\n \"max_appointments_per_day_limit_type\": \"PER_LOCATION\",\n \"max_appointments_per_day_limit\": \"\",\n \"cancellation_window_seconds\": \"\",\n \"cancellation_fee_money\": {\n \"amount\": \"\",\n \"currency\": \"LSL\"\n },\n \"cancellation_policy\": \"CANCELLATION_TREATED_AS_NO_SHOW\",\n \"cancellation_policy_text\": \"\",\n \"skip_booking_flow_staff_selection\": \"\"\n },\n \"support_seller_level_writes\": \"\"\n },\n \"errors\": [\n {\n \"category\": \"INVALID_REQUEST_ERROR\",\n \"code\": \"RATE_LIMITED\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"PAYMENT_METHOD_ERROR\",\n \"code\": \"INVALID_EXPIRATION_DATE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-5b4e1bbc-05cc-497f-880e-15ccfd931552" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-4cf8dc51-dcc5-420c-a595-a8b652dec572" } ], "id": "94325b0c-e356-4353-9b22-3d9c8e24c89d", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-94325b0c-e356-4353-9b22-3d9c8e24c89d" }, { "name": "location-booking-profiles", "item": [ { "name": "{location_id}", "item": [ { "name": "Square Retrieve Location Booking Profile", "id": "33dd7015-a505-4cc3-b759-22da6c5d94c9", "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/location-booking-profiles/:location_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "location-booking-profiles", ":location_id" ], "variable": [ { "id": "5b82da22-18c5-4e18-94e2-aa13d84df3cd", "key": "location_id", "value": "", "description": "(Required) The ID of the location to retrieve the booking profile." } ] }, "description": "Retrieves a seller's location booking profile." }, "response": [ { "id": "77a34d73-3bcf-4b3d-8e2a-ecd89f848c93", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/bookings/location-booking-profiles/:location_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "location-booking-profiles", ":location_id" ], "variable": [ { "key": "location_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"location_booking_profile\": {\n \"location_id\": \"\",\n \"booking_site_url\": \"\",\n \"online_booking_enabled\": \"\"\n },\n \"errors\": [\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"CARDHOLDER_INSUFFICIENT_PERMISSIONS\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"BUYER_REFUSED_PAYMENT\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-77a34d73-3bcf-4b3d-8e2a-ecd89f848c93" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-33dd7015-a505-4cc3-b759-22da6c5d94c9" } ], "id": "543980cd-332b-4500-b689-19f694063b63", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-543980cd-332b-4500-b689-19f694063b63" }, { "name": "Square List Location Booking Profiles", "id": "50127703-a5c8-4160-af0e-8e56c957d884", "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/location-booking-profiles?limit=&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "location-booking-profiles" ], "query": [ { "description": "The maximum number of results to return in a paged response.", "key": "limit", "value": "" }, { "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.", "key": "cursor", "value": "" } ] }, "description": "Lists location booking profiles of a seller." }, "response": [ { "id": "d083d3b9-a606-4cc2-9414-c4ea7f817b83", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/bookings/location-booking-profiles?limit=&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "location-booking-profiles" ], "query": [ { "description": "The maximum number of results to return in a paged response.", "key": "limit", "value": "" }, { "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.", "key": "cursor", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"location_booking_profiles\": [\n {\n \"location_id\": \"\",\n \"booking_site_url\": \"\",\n \"online_booking_enabled\": \"\"\n },\n {\n \"location_id\": \"\",\n \"booking_site_url\": \"\",\n \"online_booking_enabled\": \"\"\n }\n ],\n \"cursor\": \"\",\n \"errors\": [\n {\n \"category\": \"MERCHANT_SUBSCRIPTION_ERROR\",\n \"code\": \"API_VERSION_INCOMPATIBLE\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"PAYMENT_METHOD_ERROR\",\n \"code\": \"UNSUPPORTED_LOYALTY_REWARD_TIER\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-d083d3b9-a606-4cc2-9414-c4ea7f817b83" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-50127703-a5c8-4160-af0e-8e56c957d884" } ], "id": "fbaf9895-6383-4f25-a9e9-15a7b8a19b5e", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-fbaf9895-6383-4f25-a9e9-15a7b8a19b5e" }, { "name": "team-member-booking-profiles", "item": [ { "name": "bulk-retrieve", "item": [ { "name": "Square Bulk Retrieve Team Member Booking Profiles", "id": "bcdcdced-f1a5-4cd0-a4c9-95b709ed783b", "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 \"team_member_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings/team-member-booking-profiles/bulk-retrieve", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "team-member-booking-profiles", "bulk-retrieve" ] }, "description": "Retrieves one or more team members' booking profiles." }, "response": [ { "id": "414a48ab-f47a-4c1e-8de2-18327995639b", "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": "" } ], "body": { "mode": "raw", "raw": "{\n \"team_member_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings/team-member-booking-profiles/bulk-retrieve", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "team-member-booking-profiles", "bulk-retrieve" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"team_member_booking_profiles\": {\n \"cupidatat72\": {\n \"team_member_booking_profile\": {\n \"team_member_id\": \"\",\n \"description\": \"\",\n \"display_name\": \"\",\n \"is_bookable\": \"\",\n \"profile_image_url\": \"\"\n },\n \"errors\": [\n {\n \"category\": \"MERCHANT_SUBSCRIPTION_ERROR\",\n \"code\": \"V1_APPLICATION\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n },\n \"culpa_57\": {\n \"team_member_booking_profile\": {\n \"team_member_id\": \"\",\n \"description\": \"\",\n \"display_name\": \"\",\n \"is_bookable\": \"\",\n \"profile_image_url\": \"\"\n },\n \"errors\": [\n {\n \"category\": \"INVALID_REQUEST_ERROR\",\n \"code\": \"CARD_MISMATCH\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n }\n },\n \"errors\": [\n {\n \"category\": \"EXTERNAL_VENDOR_ERROR\",\n \"code\": \"INSUFFICIENT_PERMISSIONS_FOR_REFUND\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-414a48ab-f47a-4c1e-8de2-18327995639b" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-bcdcdced-f1a5-4cd0-a4c9-95b709ed783b" } ], "id": "2a408a4f-cace-4f07-b341-e9063b3ab92e", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-2a408a4f-cace-4f07-b341-e9063b3ab92e" }, { "name": "{team_member_id}", "item": [ { "name": "Square Retrieve Team Member Booking Profile", "id": "673f04cb-1547-42f2-8bcd-819311506186", "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/team-member-booking-profiles/:team_member_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "team-member-booking-profiles", ":team_member_id" ], "variable": [ { "id": "efd01b2f-16d5-492c-87ed-e1437b139ae6", "key": "team_member_id", "value": "", "description": "(Required) The ID of the team member to retrieve." } ] }, "description": "Retrieves a team member's booking profile." }, "response": [ { "id": "a0ef3032-82b9-46e9-8d6c-f7b31abd2820", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/bookings/team-member-booking-profiles/:team_member_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "team-member-booking-profiles", ":team_member_id" ], "variable": [ { "key": "team_member_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"team_member_booking_profile\": {\n \"team_member_id\": \"\",\n \"description\": \"\",\n \"display_name\": \"\",\n \"is_bookable\": \"\",\n \"profile_image_url\": \"\"\n },\n \"errors\": [\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"RATE_LIMIT_ERROR\",\n \"code\": \"ARRAY_LENGTH_TOO_SHORT\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-a0ef3032-82b9-46e9-8d6c-f7b31abd2820" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-673f04cb-1547-42f2-8bcd-819311506186" } ], "id": "122e0579-1d6a-4593-8fdf-70f69d7b851f", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-122e0579-1d6a-4593-8fdf-70f69d7b851f" }, { "name": "Square List Team Member Booking Profiles", "id": "9854df42-4f47-47ea-b087-a151805ecba9", "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/team-member-booking-profiles?bookable_only=false&limit=&cursor=&location_id=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "team-member-booking-profiles" ], "query": [ { "description": "Indicates whether to include only bookable team members in the returned result (`true`) or not (`false`).", "key": "bookable_only", "value": "false" }, { "description": "The maximum number of results to return in a paged response.", "key": "limit", "value": "" }, { "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.", "key": "cursor", "value": "" }, { "description": "Indicates whether to include only team members enabled at the given location in the returned result.", "key": "location_id", "value": "" } ] }, "description": "Lists booking profiles for team members." }, "response": [ { "id": "f4bd4437-0c7c-4508-b76c-a5589bcb0f73", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/bookings/team-member-booking-profiles?bookable_only=false&limit=&cursor=&location_id=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", "team-member-booking-profiles" ], "query": [ { "description": "Indicates whether to include only bookable team members in the returned result (`true`) or not (`false`).", "key": "bookable_only", "value": "false" }, { "description": "The maximum number of results to return in a paged response.", "key": "limit", "value": "" }, { "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.", "key": "cursor", "value": "" }, { "description": "Indicates whether to include only team members enabled at the given location in the returned result.", "key": "location_id", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"team_member_booking_profiles\": [\n {\n \"team_member_id\": \"\",\n \"description\": \"\",\n \"display_name\": \"\",\n \"is_bookable\": \"\",\n \"profile_image_url\": \"\"\n },\n {\n \"team_member_id\": \"\",\n \"description\": \"\",\n \"display_name\": \"\",\n \"is_bookable\": \"\",\n \"profile_image_url\": \"\"\n }\n ],\n \"cursor\": \"\",\n \"errors\": [\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"PAYMENT_NOT_REFUNDABLE_DUE_TO_DISPUTE\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"API_ERROR\",\n \"code\": \"BAD_GATEWAY\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-f4bd4437-0c7c-4508-b76c-a5589bcb0f73" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-9854df42-4f47-47ea-b087-a151805ecba9" } ], "id": "d9bb094b-8e47-4252-a8fa-f3c23867ab12", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-d9bb094b-8e47-4252-a8fa-f3c23867ab12" }, { "name": "{booking_id}", "item": [ { "name": "cancel", "item": [ { "name": "Square Cancel Booking", "id": "de9afd35-e0b7-4470-a80b-6d28d0782854", "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 \"idempotency_key\": \"\",\n \"booking_version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings/:booking_id/cancel", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", ":booking_id", "cancel" ], "variable": [ { "id": "22608196-0e23-42b7-8a9a-d4142114f57f", "key": "booking_id", "value": "", "description": "(Required) The ID of the [Booking](entity:Booking) object representing the to-be-cancelled booking." } ] }, "description": "Cancels an existing booking.\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": "fda5186d-3e34-4baf-91e3-659ce9337595", "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": "" } ], "body": { "mode": "raw", "raw": "{\n \"idempotency_key\": \"\",\n \"booking_version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings/:booking_id/cancel", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", ":booking_id", "cancel" ], "variable": [ { "key": "booking_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"booking\": {\n \"id\": \"\",\n \"version\": \"\",\n \"status\": \"CANCELLED_BY_CUSTOMER\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"customer_id\": \"\",\n \"customer_note\": \"\",\n \"seller_note\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\"\n ]\n }\n ],\n \"transition_time_minutes\": \"\",\n \"all_day\": \"\",\n \"location_type\": \"PHONE\",\n \"creator_details\": {\n \"creator_type\": \"CUSTOMER\",\n \"team_member_id\": \"\",\n \"customer_id\": \"\"\n },\n \"source\": \"FIRST_PARTY_BUYER\",\n \"address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"SI\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n }\n },\n \"errors\": [\n {\n \"category\": \"AUTHENTICATION_ERROR\",\n \"code\": \"VERIFY_AVS_FAILURE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-fda5186d-3e34-4baf-91e3-659ce9337595" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-de9afd35-e0b7-4470-a80b-6d28d0782854" } ], "id": "d075e9cf-b2b7-41e1-b4da-c734d818029d", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-d075e9cf-b2b7-41e1-b4da-c734d818029d" }, { "name": "Square Retrieve Booking", "id": "f619454c-6a95-4e8e-b0ca-1844f7e85198", "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", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", ":booking_id" ], "variable": [ { "id": "a138417d-ea98-4485-8958-ef72282bac7e", "key": "booking_id", "value": "", "description": "(Required) The ID of the [Booking](entity:Booking) object representing the to-be-retrieved booking." } ] }, "description": "Retrieves a booking.\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": "1885754a-2929-4716-b72d-4793b4225619", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/bookings/:booking_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", ":booking_id" ], "variable": [ { "key": "booking_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"booking\": {\n \"id\": \"\",\n \"version\": \"\",\n \"status\": \"CANCELLED_BY_CUSTOMER\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"customer_id\": \"\",\n \"customer_note\": \"\",\n \"seller_note\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\"\n ]\n }\n ],\n \"transition_time_minutes\": \"\",\n \"all_day\": \"\",\n \"location_type\": \"PHONE\",\n \"creator_details\": {\n \"creator_type\": \"CUSTOMER\",\n \"team_member_id\": \"\",\n \"customer_id\": \"\"\n },\n \"source\": \"FIRST_PARTY_BUYER\",\n \"address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"SB\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n }\n },\n \"errors\": [\n {\n \"category\": \"INVALID_REQUEST_ERROR\",\n \"code\": \"INVALID_PIN\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-1885754a-2929-4716-b72d-4793b4225619" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-f619454c-6a95-4e8e-b0ca-1844f7e85198" }, { "name": "Square Update Booking", "id": "1f2e3d44-4f29-433d-9667-b3dc853c2c43", "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 \"booking\": {\n \"id\": \"\",\n \"version\": \"\",\n \"status\": \"CANCELLED_BY_SELLER\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"customer_id\": \"\",\n \"customer_note\": \"\",\n \"seller_note\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"transition_time_minutes\": \"\",\n \"all_day\": \"\",\n \"location_type\": \"BUSINESS_LOCATION\",\n \"creator_details\": {\n \"creator_type\": \"CUSTOMER\",\n \"team_member_id\": \"\",\n \"customer_id\": \"\"\n },\n \"source\": \"FIRST_PARTY_BUYER\",\n \"address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"MA\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n }\n },\n \"idempotency_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings/:booking_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", ":booking_id" ], "variable": [ { "id": "15b373a3-d28a-4015-aba1-23172ca7557f", "key": "booking_id", "value": "", "description": "(Required) The ID of the [Booking](entity:Booking) object representing the to-be-updated booking." } ] }, "description": "Updates a booking.\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": "d9bdcbeb-b4a3-48f2-96fe-374cd1c4fb5c", "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": "" } ], "body": { "mode": "raw", "raw": "{\n \"booking\": {\n \"id\": \"\",\n \"version\": \"\",\n \"status\": \"CANCELLED_BY_SELLER\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"customer_id\": \"\",\n \"customer_note\": \"\",\n \"seller_note\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"transition_time_minutes\": \"\",\n \"all_day\": \"\",\n \"location_type\": \"BUSINESS_LOCATION\",\n \"creator_details\": {\n \"creator_type\": \"CUSTOMER\",\n \"team_member_id\": \"\",\n \"customer_id\": \"\"\n },\n \"source\": \"FIRST_PARTY_BUYER\",\n \"address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"MA\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n }\n },\n \"idempotency_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings/:booking_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings", ":booking_id" ], "variable": [ { "key": "booking_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"booking\": {\n \"id\": \"\",\n \"version\": \"\",\n \"status\": \"DECLINED\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"customer_id\": \"\",\n \"customer_note\": \"\",\n \"seller_note\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\"\n ]\n }\n ],\n \"transition_time_minutes\": \"\",\n \"all_day\": \"\",\n \"location_type\": \"PHONE\",\n \"creator_details\": {\n \"creator_type\": \"TEAM_MEMBER\",\n \"team_member_id\": \"\",\n \"customer_id\": \"\"\n },\n \"source\": \"FIRST_PARTY_BUYER\",\n \"address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"WF\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n }\n },\n \"errors\": [\n {\n \"category\": \"INVALID_REQUEST_ERROR\",\n \"code\": \"PAYMENT_AMOUNT_MISMATCH\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-d9bdcbeb-b4a3-48f2-96fe-374cd1c4fb5c" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-1f2e3d44-4f29-433d-9667-b3dc853c2c43" } ], "id": "ef8a8a45-8c01-4d7b-a5c8-40224565d8b6", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-ef8a8a45-8c01-4d7b-a5c8-40224565d8b6" }, { "name": "Square List Bookings", "id": "6b1c9c45-d82c-42c0-9fbe-997c3d62cd41", "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?limit=&cursor=&customer_id=&team_member_id=&location_id=&start_at_min=&start_at_max=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings" ], "query": [ { "description": "The maximum number of results per page to return in a paged response.", "key": "limit", "value": "" }, { "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.", "key": "cursor", "value": "" }, { "description": "The [customer](entity:Customer) for whom to retrieve bookings. If this is not set, bookings for all customers are retrieved.", "key": "customer_id", "value": "" }, { "description": "The team member for whom to retrieve bookings. If this is not set, bookings of all members are retrieved.", "key": "team_member_id", "value": "" }, { "description": "The location for which to retrieve bookings. If this is not set, all locations' bookings are retrieved.", "key": "location_id", "value": "" }, { "description": "The RFC 3339 timestamp specifying the earliest of the start time. If this is not set, the current time is used.", "key": "start_at_min", "value": "" }, { "description": "The RFC 3339 timestamp specifying the latest of the start time. If this is not set, the time of 31 days after `start_at_min` is used.", "key": "start_at_max", "value": "" } ] }, "description": "Retrieve a collection of bookings.\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": "623c461a-0c63-4ba9-b26f-2d23184085db", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/bookings?limit=&cursor=&customer_id=&team_member_id=&location_id=&start_at_min=&start_at_max=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings" ], "query": [ { "description": "The maximum number of results per page to return in a paged response.", "key": "limit", "value": "" }, { "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.", "key": "cursor", "value": "" }, { "description": "The [customer](entity:Customer) for whom to retrieve bookings. If this is not set, bookings for all customers are retrieved.", "key": "customer_id", "value": "" }, { "description": "The team member for whom to retrieve bookings. If this is not set, bookings of all members are retrieved.", "key": "team_member_id", "value": "" }, { "description": "The location for which to retrieve bookings. If this is not set, all locations' bookings are retrieved.", "key": "location_id", "value": "" }, { "description": "The RFC 3339 timestamp specifying the earliest of the start time. If this is not set, the current time is used.", "key": "start_at_min", "value": "" }, { "description": "The RFC 3339 timestamp specifying the latest of the start time. If this is not set, the time of 31 days after `start_at_min` is used.", "key": "start_at_max", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"bookings\": [\n {\n \"id\": \"\",\n \"version\": \"\",\n \"status\": \"NO_SHOW\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"customer_id\": \"\",\n \"customer_note\": \"\",\n \"seller_note\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\"\n ]\n }\n ],\n \"transition_time_minutes\": \"\",\n \"all_day\": \"\",\n \"location_type\": \"BUSINESS_LOCATION\",\n \"creator_details\": {\n \"creator_type\": \"TEAM_MEMBER\",\n \"team_member_id\": \"\",\n \"customer_id\": \"\"\n },\n \"source\": \"FIRST_PARTY_BUYER\",\n \"address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"HU\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n }\n }\n ],\n \"cursor\": \"\",\n \"errors\": [\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"DELAYED_TRANSACTION_FAILED\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-623c461a-0c63-4ba9-b26f-2d23184085db" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-6b1c9c45-d82c-42c0-9fbe-997c3d62cd41" }, { "name": "Square Create Booking", "id": "c51ade18-b916-4267-81ca-6ba58fbba054", "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 \"booking\": {\n \"id\": \"\",\n \"version\": \"\",\n \"status\": \"NO_SHOW\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"customer_id\": \"\",\n \"customer_note\": \"\",\n \"seller_note\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"transition_time_minutes\": \"\",\n \"all_day\": \"\",\n \"location_type\": \"BUSINESS_LOCATION\",\n \"creator_details\": {\n \"creator_type\": \"TEAM_MEMBER\",\n \"team_member_id\": \"\",\n \"customer_id\": \"\"\n },\n \"source\": \"FIRST_PARTY_BUYER\",\n \"address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"MK\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n }\n },\n \"idempotency_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings" ] }, "description": "Creates a booking.\n\nThe required input must include the following:\n- `Booking.location_id`\n- `Booking.start_at`\n- `Booking.AppointmentSegment.team_member_id`\n- `Booking.AppointmentSegment.service_variation_id`\n- `Booking.AppointmentSegment.service_variation_version`\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": "f69345a4-2aa8-44ce-8752-c710efc717d2", "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": "" } ], "body": { "mode": "raw", "raw": "{\n \"booking\": {\n \"id\": \"\",\n \"version\": \"\",\n \"status\": \"NO_SHOW\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"customer_id\": \"\",\n \"customer_note\": \"\",\n \"seller_note\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"transition_time_minutes\": \"\",\n \"all_day\": \"\",\n \"location_type\": \"BUSINESS_LOCATION\",\n \"creator_details\": {\n \"creator_type\": \"TEAM_MEMBER\",\n \"team_member_id\": \"\",\n \"customer_id\": \"\"\n },\n \"source\": \"FIRST_PARTY_BUYER\",\n \"address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"MK\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n }\n },\n \"idempotency_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/bookings", "host": [ "{{baseUrl}}" ], "path": [ "v2", "bookings" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"booking\": {\n \"id\": \"\",\n \"version\": \"\",\n \"status\": \"CANCELLED_BY_SELLER\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"start_at\": \"\",\n \"location_id\": \"\",\n \"customer_id\": \"\",\n \"customer_note\": \"\",\n \"seller_note\": \"\",\n \"appointment_segments\": [\n {\n \"team_member_id\": \"\",\n \"duration_minutes\": \"\",\n \"service_variation_id\": \"\",\n \"service_variation_version\": \"\",\n \"intermission_minutes\": \"\",\n \"any_team_member\": \"\",\n \"resource_ids\": [\n \"\"\n ]\n }\n ],\n \"transition_time_minutes\": \"\",\n \"all_day\": \"\",\n \"location_type\": \"PHONE\",\n \"creator_details\": {\n \"creator_type\": \"CUSTOMER\",\n \"team_member_id\": \"\",\n \"customer_id\": \"\"\n },\n \"source\": \"API\",\n \"address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"KE\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n }\n },\n \"errors\": [\n {\n \"category\": \"RATE_LIMIT_ERROR\",\n \"code\": \"REFUND_AMOUNT_INVALID\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:01:48.000Z", "updatedAt": "2026-07-28T03:01:48.000Z", "uid": "35240-f69345a4-2aa8-44ce-8752-c710efc717d2" } ], "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-c51ade18-b916-4267-81ca-6ba58fbba054" } ], "id": "c1a4a0de-6c9c-46ae-9b2d-5d4ce3b60f6f", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-c1a4a0de-6c9c-46ae-9b2d-5d4ce3b60f6f" } ], "id": "b24df6bf-3809-4a7c-a5f7-3540d072d4b4", "createdAt": "2026-07-28T03:01:47.000Z", "updatedAt": "2026-07-28T03:01:47.000Z", "uid": "35240-b24df6bf-3809-4a7c-a5f7-3540d072d4b4" } ], "variable": [ { "key": "baseUrl", "value": "https://connect.squareup.com" } ] }