Connectors
Finance, Billing & Payments
Square
Payments and commerce: payments, orders, customers, catalog, and inventory
Square API referenceAPI checked August 18, 2026
- Signs in with
- API token
- Runs on
- Cloud or On-Prem Worker
- Operations
- 334
- Ready-made triggers
- 42
Connect Square
- In Neblex open Connect › Connections and click New Connection.
- Search for Square and give the connection a clear name.
- Fill in the fields. Secret values are encrypted and never shown again.
- Click Test, then Create Connection.
| Field | What to enter |
|---|---|
| Access tokenRequiredSecret | |
| OAuth application secretOptionalSecret |
Triggers
Start a flow when something changes in Square: add a Poll for changes trigger, choose Square and pick the event.
| Event | What it does | How |
|---|---|---|
| New or updated bankaccount | Fires for each bankaccount that appears or changes since the last check. | Checks for changes |
| New or updated booking | Fires for each booking that appears or changes since the last check. | Checks for changes |
| New or updated labor | Fires for each labor that appears or changes since the last check. | Checks for changes |
| New or updated card | Fires for each card that appears or changes since the last check. | Checks for changes |
| New or updated catalog | Fires for each catalog that appears or changes since the last check. | Checks for changes |
| New or updated channel | Fires for each channel that appears or changes since the last check. | Checks for changes |
| New or updated customergroup | Fires for each customergroup that appears or changes since the last check. | Checks for changes |
| New or updated customer | Fires for each customer that appears or changes since the last check. | Checks for changes |
| New or updated device | Fires for each device that appears or changes since the last check. | Checks for changes |
| New or updated dispute | Fires for each dispute that appears or changes since the last check. | Checks for changes |
| New or updated giftcardactivity | Fires for each giftcardactivity that appears or changes since the last check. | Checks for changes |
| New or updated giftcard | Fires for each giftcard that appears or changes since the last check. | Checks for changes |
| New or updated invoice | Fires for each invoice that appears or changes since the last check. | Checks for changes |
| New or updated team | Fires for each team that appears or changes since the last check. | Checks for changes |
| New or updated loyalty | Fires for each loyalty that appears or changes since the last check. | Checks for changes |
| New or updated checkout | Fires for each checkout that appears or changes since the last check. | Checks for changes |
| New or updated refund | Fires for each refund that appears or changes since the last check. | Checks for changes |
| New or updated payment | Fires for each payment that appears or changes since the last check. | Checks for changes |
| New or updated subscription | Fires for each subscription that appears or changes since the last check. | Checks for changes |
| New or updated transaction | Fires for each transaction that appears or changes since the last check. | Checks for changes |
| New or updated webhooksubscription | Fires for each webhooksubscription that appears or changes since the last check. | Checks for changes |
| New bankaccount | Fires for each bankaccount that appears since the last check. | Checks for changes |
| New booking | Fires for each booking that appears since the last check. | Checks for changes |
| New labor | Fires for each labor that appears since the last check. | Checks for changes |
| New card | Fires for each card that appears since the last check. | Checks for changes |
| New catalog | Fires for each catalog that appears since the last check. | Checks for changes |
| New channel | Fires for each channel that appears since the last check. | Checks for changes |
| New customergroup | Fires for each customergroup that appears since the last check. | Checks for changes |
| New customer | Fires for each customer that appears since the last check. | Checks for changes |
| New device | Fires for each device that appears since the last check. | Checks for changes |
| New dispute | Fires for each dispute that appears since the last check. | Checks for changes |
| New giftcardactivity | Fires for each giftcardactivity that appears since the last check. | Checks for changes |
| New giftcard | Fires for each giftcard that appears since the last check. | Checks for changes |
| New invoice | Fires for each invoice that appears since the last check. | Checks for changes |
| New team | Fires for each team that appears since the last check. | Checks for changes |
| New loyalty | Fires for each loyalty that appears since the last check. | Checks for changes |
| New checkout | Fires for each checkout that appears since the last check. | Checks for changes |
| New refund | Fires for each refund that appears since the last check. | Checks for changes |
| New payment | Fires for each payment that appears since the last check. | Checks for changes |
| New subscription | Fires for each subscription that appears since the last check. | Checks for changes |
| New transaction | Fires for each transaction that appears since the last check. | Checks for changes |
| New webhooksubscription | Fires for each webhooksubscription that appears since the last check. | Checks for changes |
Use it in a flow
- Open a flow, open the node library and search for Square.
- Drag it onto the canvas and choose an Operation and your connection.
- Map the operation's fields from earlier steps, or click Map with Matt.
- Use Test this step to see what it returns, then save.
Operations
334 operations in 43 groups. Each one is a step you can add to a flow.
ApplePay1
Register DomainRegisterDomain | POST | Activates a domain for use with Apple Pay on the Web and Square. |
BankAccount5
Create Bank AccountCreateBankAccount | POST | Store a bank account on file for a square account |
Disable Bank AccountDisableBankAccount | POST | Disable a bank account. |
Get Bank AccountGetBankAccount | GET | Retrieve details of a BankAccount bank account linked to a Square account. |
Get Bank Account By V 1 IdGetBankAccountByV1Id | GET | Returns details of a BankAccount identified by V1 bank account ID. |
List Bank AccountsListBankAccounts | GET | Returns a list of BankAccount objects linked to a Square account. |
Booking13
Bulk Retrieve BookingsBulkRetrieveBookings | POST | Bulk-Retrieves a list of bookings by booking IDs. |
Bulk Retrieve Team Member Booking ProfilesBulkRetrieveTeamMemberBookingProfiles | POST | Retrieves one or more team members' booking profiles. |
Cancel BookingCancelBooking | POST | Cancels an existing booking. |
Create BookingCreateBooking | POST | Creates a booking. |
List BookingsListBookings | GET | Retrieve a collection of bookings. |
List Location Booking ProfilesListLocationBookingProfiles | GET | Lists location booking profiles of a seller. |
List Team Member Booking ProfilesListTeamMemberBookingProfiles | GET | Lists booking profiles for team members. |
Retrieve BookingRetrieveBooking | GET | Retrieves a booking. |
Retrieve Business Booking ProfileRetrieveBusinessBookingProfile | GET | Retrieves a seller's booking profile. |
Retrieve Location Booking ProfileRetrieveLocationBookingProfile | GET | Retrieves a seller's location booking profile. |
Retrieve Team Member Booking ProfileRetrieveTeamMemberBookingProfile | GET | Retrieves a team member's booking profile. |
Search AvailabilitySearchAvailability | POST | Searches for availabilities for booking. |
Update BookingUpdateBooking | PUT | Updates a booking. |
BookingCustomAttribute11
Bulk Delete Booking Custom AttributesBulkDeleteBookingCustomAttributes | POST | Bulk deletes bookings custom attributes. |
Bulk Upsert Booking Custom AttributesBulkUpsertBookingCustomAttributes | POST | Bulk upserts bookings custom attributes. |
Create Booking Custom Attribute DefinitionCreateBookingCustomAttributeDefinition | POST | Creates a bookings custom attribute definition. |
Delete Booking Custom AttributeDeleteBookingCustomAttribute | DELETE | Deletes a bookings custom attribute. |
Delete Booking Custom Attribute DefinitionDeleteBookingCustomAttributeDefinition | DELETE | Deletes a bookings custom attribute definition. |
List Booking Custom Attribute DefinitionsListBookingCustomAttributeDefinitions | GET | Get all bookings custom attribute definitions. |
List Booking Custom AttributesListBookingCustomAttributes | GET | Lists a booking's custom attributes. |
Retrieve Booking Custom AttributeRetrieveBookingCustomAttribute | GET | Retrieves a bookings custom attribute. |
Retrieve Booking Custom Attribute DefinitionRetrieveBookingCustomAttributeDefinition | GET | Retrieves a bookings custom attribute definition. |
Update Booking Custom Attribute DefinitionUpdateBookingCustomAttributeDefinition | PUT | Updates a bookings custom attribute definition. |
Upsert Booking Custom AttributeUpsertBookingCustomAttribute | PUT | Upserts a bookings custom attribute. |
Card4
Create CardCreateCard | POST | Adds a card on file to an existing merchant. |
Disable CardDisableCard | POST | Disables the card, preventing any further updates or charges. |
List CardsListCards | GET | Retrieves a list of cards owned by the account making the request. |
Retrieve CardRetrieveCard | GET | Retrieves details for a specific Card. |
CashDrawer3
List Cash Drawer Shift EventsListCashDrawerShiftEvents | GET | Provides a paginated list of events for a single cash drawer shift. |
List Cash Drawer ShiftsListCashDrawerShifts | GET | Provides the details for all of the cash drawer shifts for a location in a date range. |
Retrieve Cash Drawer ShiftRetrieveCashDrawerShift | GET | Provides the summary details for a single cash drawer shift. |
Catalog14
Batch Delete Catalog ObjectsBatchDeleteCatalogObjects | POST | Deletes a set of CatalogItems based on the provided list of target IDs and returns a set of successfully deleted IDs in the response. |
Batch Retrieve Catalog ObjectsBatchRetrieveCatalogObjects | POST | Returns a set of objects based on the provided ID. |
Batch Upsert Catalog ObjectsBatchUpsertCatalogObjects | POST | Creates or updates up to 10,000 target objects based on the provided list of objects. |
Catalog InfoCatalogInfo | GET | Retrieves information about the Square Catalog API, such as batch size limits that can be used by the BatchUpsertCatalogObjects endpoint. |
Create Catalog ImageCreateCatalogImage | POST | Uploads an image file to be represented by a CatalogImage object that can be linked to an existing CatalogObject instance. |
Delete Catalog ObjectDeleteCatalogObject | DELETE | Deletes a single CatalogObject based on the provided ID and returns the set of successfully deleted IDs in the response. |
List CatalogListCatalog | GET | Returns a list of all CatalogObjects of the specified types in the catalog. |
Retrieve Catalog ObjectRetrieveCatalogObject | GET | Returns a single CatalogItem as a CatalogObject based on the provided ID. |
Search Catalog ItemsSearchCatalogItems | POST | Searches for catalog items or item variations by matching supported search attribute values, including custom attribute values, against one or more of the specified query filters. |
Search Catalog ObjectsSearchCatalogObjects | POST | Searches for CatalogObject of any type by matching supported search attribute values, excluding custom attribute values on items or item variations, against one or more of the specified... |
Update Catalog ImageUpdateCatalogImage | PUT | Uploads a new image file to replace the existing one in the specified CatalogImage object. |
Update Item Modifier ListsUpdateItemModifierLists | POST | Updates the CatalogModifierList objects that apply to the targeted CatalogItem without having to perform an upsert on the entire item. |
Update Item TaxesUpdateItemTaxes | POST | Updates the CatalogTax objects that apply to the targeted CatalogItem without having to perform an upsert on the entire item. |
Upsert Catalog ObjectUpsertCatalogObject | POST | Creates a new or updates the specified CatalogObject. |
Channel3
Bulk Retrieve ChannelsBulkRetrieveChannels | POST | |
List ChannelsListChannels | GET | |
Retrieve ChannelRetrieveChannel | GET |
Checkout10
Create CheckoutCreateCheckout | POST | Links a checkoutId to a checkout page url that customers are directed to in order to provide their payment information using a payment processing workflow hosted on connect.squareup.com. |
Create Payment LinkCreatePaymentLink | POST | Creates a Square-hosted checkout page. |
Delete Payment LinkDeletePaymentLink | DELETE | Deletes a payment link. |
List Payment LinksListPaymentLinks | GET | Lists all payment links. |
Retrieve Location SettingsRetrieveLocationSettings | GET | Retrieves the location-level settings for a Square-hosted checkout page. |
Retrieve Merchant SettingsRetrieveMerchantSettings | GET | Retrieves the merchant-level settings for a Square-hosted checkout page. |
Retrieve Payment LinkRetrievePaymentLink | GET | Retrieves a payment link. |
Update Location SettingsUpdateLocationSettings | PUT | Updates the location-level settings for a Square-hosted checkout page. |
Update Merchant SettingsUpdateMerchantSettings | PUT | Updates the merchant-level settings for a Square-hosted checkout page. |
Update Payment LinkUpdatePaymentLink | PUT | Updates a payment link. |
Customer14
Add Group To CustomerAddGroupToCustomer | PUT | Adds a group membership to a customer. |
Bulk Create CustomersBulkCreateCustomers | POST | Creates multiple customer profiles for a business. |
Bulk Delete CustomersBulkDeleteCustomers | POST | Deletes multiple customer profiles. |
Bulk Retrieve CustomersBulkRetrieveCustomers | POST | Retrieves multiple customer profiles. |
Bulk Update CustomersBulkUpdateCustomers | POST | Updates multiple customer profiles. |
Create CustomerCreateCustomer | POST | Creates a new customer for a business. |
Create Customer CardCreateCustomerCard | POST | Adds a card on file to an existing customer. |
Delete CustomerDeleteCustomer | DELETE | Deletes a customer profile from a business. |
Delete Customer CardDeleteCustomerCard | DELETE | Removes a card on file from a customer. |
List CustomersListCustomers | GET | Lists customer profiles associated with a Square account. |
Remove Group From CustomerRemoveGroupFromCustomer | DELETE | Removes a group membership from a customer. |
Retrieve CustomerRetrieveCustomer | GET | Returns details for a single customer. |
Search CustomersSearchCustomers | POST | Searches the customer profiles associated with a Square account using one or more supported query filters. |
Update CustomerUpdateCustomer | PUT | Updates a customer profile. |
CustomerCustomAttribute10
Bulk Upsert Customer Custom AttributesBulkUpsertCustomerCustomAttributes | POST | Creates or updates custom attributes for customer profiles as a bulk operation. |
Create Customer Custom Attribute DefinitionCreateCustomerCustomAttributeDefinition | POST | Creates a customer-related custom attribute definition for a Square seller account. |
Delete Customer Custom AttributeDeleteCustomerCustomAttribute | DELETE | Deletes a custom attribute associated with a customer profile. |
Delete Customer Custom Attribute DefinitionDeleteCustomerCustomAttributeDefinition | DELETE | Deletes a customer-related custom attribute definition from a Square seller account. |
List Customer Custom Attribute DefinitionsListCustomerCustomAttributeDefinitions | GET | Lists the customer-related custom attribute definitions that belong to a Square seller account. |
List Customer Custom AttributesListCustomerCustomAttributes | GET | Lists the custom attributes associated with a customer profile. |
Retrieve Customer Custom AttributeRetrieveCustomerCustomAttribute | GET | Retrieves a custom attribute associated with a customer profile. |
Retrieve Customer Custom Attribute DefinitionRetrieveCustomerCustomAttributeDefinition | GET | Retrieves a customer-related custom attribute definition from a Square seller account. |
Update Customer Custom Attribute DefinitionUpdateCustomerCustomAttributeDefinition | PUT | Updates a customer-related custom attribute definition for a Square seller account. |
Upsert Customer Custom AttributeUpsertCustomerCustomAttribute | POST | Creates or updates a custom attribute for a customer profile. |
CustomerGroup5
Create Customer GroupCreateCustomerGroup | POST | Creates a new customer group for a business. |
Delete Customer GroupDeleteCustomerGroup | DELETE | Deletes a customer group as identified by the group id value. |
List Customer GroupsListCustomerGroups | GET | Retrieves the list of customer groups of a business. |
Retrieve Customer GroupRetrieveCustomerGroup | GET | Retrieves a specific customer group as identified by the group id value. |
Update Customer GroupUpdateCustomerGroup | PUT | Updates a customer group as identified by the group id value. |
CustomerSegment2
List Customer SegmentsListCustomerSegments | GET | Retrieves the list of customer segments of a business. |
Retrieve Customer SegmentRetrieveCustomerSegment | GET | Retrieves a specific customer segment as identified by the segment id value. |
Device5
Create Device CodeCreateDeviceCode | POST | Creates a DeviceCode that can be used to login to a Square Terminal device to enter the connected terminal mode. |
Get DeviceGetDevice | GET | Retrieves Device with the associated device id. |
Get Device CodeGetDeviceCode | GET | Retrieves DeviceCode with the associated ID. |
List Device CodesListDeviceCodes | GET | Lists all DeviceCodes associated with the merchant. |
List DevicesListDevices | GET | List devices associated with the merchant. |
Dispute9
Accept DisputeAcceptDispute | POST | Accepts the loss on a dispute. |
Create Dispute Evidence FileCreateDisputeEvidenceFile | POST | Uploads a file to use as evidence in a dispute challenge. |
Create Dispute Evidence TextCreateDisputeEvidenceText | POST | Uploads text to use as evidence for a dispute challenge. |
Delete Dispute EvidenceDeleteDisputeEvidence | DELETE | Removes specified evidence from a dispute. |
List Dispute EvidenceListDisputeEvidence | GET | Returns a list of evidence associated with a dispute. |
List DisputesListDisputes | GET | Returns a list of disputes associated with a particular account. |
Retrieve DisputeRetrieveDispute | GET | Returns details about a specific dispute. |
Retrieve Dispute EvidenceRetrieveDisputeEvidence | GET | Returns the metadata for the evidence specified in the request URL path. |
Submit EvidenceSubmitEvidence | POST | Submits evidence to the cardholder's bank. |
Employee2
List EmployeesListEmployees | GET | |
Retrieve EmployeeRetrieveEmployee | GET |
Event4
Disable EventsDisableEvents | PUT | Disables events to prevent them from being searchable. |
Enable EventsEnableEvents | PUT | Enables events to make them searchable. |
List Event TypesListEventTypes | GET | Lists all event types that you can subscribe to as webhooks or query using the Events API. |
Search EventsSearchEvents | POST | Search for Square API events that occur within a 28-day timeframe. |
GiftCard7
Create Gift CardCreateGiftCard | POST | Creates a digital gift card or registers a physical (plastic) gift card. |
Link Customer To Gift CardLinkCustomerToGiftCard | POST | Links a customer to a gift card, which is also referred to as adding a card on file. |
List Gift CardsListGiftCards | GET | Lists all gift cards. |
Retrieve Gift CardRetrieveGiftCard | GET | Retrieves a gift card using the gift card ID. |
Retrieve Gift Card From GANRetrieveGiftCardFromGAN | POST | Retrieves a gift card using the gift card account number (GAN). |
Retrieve Gift Card From NonceRetrieveGiftCardFromNonce | POST | Retrieves a gift card using a secure payment token that represents the gift card. |
Unlink Customer From Gift CardUnlinkCustomerFromGiftCard | POST | Unlinks a customer from a gift card, which is also referred to as removing a card on file. |
GiftCardActivity2
Create Gift Card ActivityCreateGiftCardActivity | POST | Creates a gift card activity to manage the balance or state of a gift card. |
List Gift Card ActivitiesListGiftCardActivities | GET | Lists gift card activities. |
Inventory19
Batch Change InventoryBatchChangeInventory | POST | Applies adjustments and counts to the provided item quantities. |
Batch Retrieve Inventory ChangesBatchRetrieveInventoryChanges | POST | Returns historical physical counts and adjustments based on the provided filter criteria. |
Batch Retrieve Inventory CountsBatchRetrieveInventoryCounts | POST | Returns current counts for the provided CatalogObjects at the requested Locations. |
Create Inventory Adjustment ReasonCreateInventoryAdjustmentReason | POST | Creates a custom inventory adjustment reason. |
Delete Inventory Adjustment ReasonDeleteInventoryAdjustmentReason | POST | Soft deletes a custom inventory adjustment reason. |
Deprecated Batch Change InventoryDeprecatedBatchChangeInventory | POST | Deprecated version of BatchChangeInventory after the endpoint URL is updated to conform to the standard convention. |
Deprecated Batch Retrieve Inventory ChangesDeprecatedBatchRetrieveInventoryChanges | POST | Deprecated version of BatchRetrieveInventoryChanges after the endpoint URL is updated to conform to the standard convention. |
Deprecated Batch Retrieve Inventory CountsDeprecatedBatchRetrieveInventoryCounts | POST | Deprecated version of BatchRetrieveInventoryCounts after the endpoint URL is updated to conform to the standard convention. |
Deprecated Retrieve Inventory AdjustmentDeprecatedRetrieveInventoryAdjustment | GET | Deprecated version of RetrieveInventoryAdjustment after the endpoint URL is updated to conform to the standard convention. |
Deprecated Retrieve Inventory Physical CountDeprecatedRetrieveInventoryPhysicalCount | GET | Deprecated version of RetrieveInventoryPhysicalCount after the endpoint URL is updated to conform to the standard convention. |
List Inventory Adjustment ReasonsListInventoryAdjustmentReasons | GET | Returns the standard and custom inventory adjustment reasons available to the seller. |
Restore Inventory Adjustment ReasonRestoreInventoryAdjustmentReason | POST | Restores a soft-deleted custom inventory adjustment reason. |
Retrieve Inventory AdjustmentRetrieveInventoryAdjustment | GET | Returns the InventoryAdjustment object with the provided adjustment id. |
Retrieve Inventory Adjustment ReasonRetrieveInventoryAdjustmentReason | POST | Returns the inventory adjustment reason identified by the provided reason id. |
Retrieve Inventory ChangesRetrieveInventoryChanges | GET | Returns a set of physical counts and inventory adjustments for the provided CatalogObject at the requested Locations. |
Retrieve Inventory CountRetrieveInventoryCount | GET | Retrieves the current calculated stock count for a given CatalogObject at a given set of Locations. |
Retrieve Inventory Physical CountRetrieveInventoryPhysicalCount | GET | Returns the InventoryPhysicalCount object with the provided physical count id. |
Update Inventory AdjustmentUpdateInventoryAdjustment | PUT | Applies an update to the provided adjustment. |
Update Inventory Adjustment ReasonUpdateInventoryAdjustmentReason | PUT | Updates a custom inventory adjustment reason. |
Invoice10
Cancel InvoiceCancelInvoice | POST | Cancels an invoice. |
Create InvoiceCreateInvoice | POST | Creates a draft invoice for an order created using the Orders API. |
Create Invoice AttachmentCreateInvoiceAttachment | POST | Uploads a file and attaches it to an invoice. |
Delete InvoiceDeleteInvoice | DELETE | Deletes the specified invoice. |
Delete Invoice AttachmentDeleteInvoiceAttachment | DELETE | Removes an attachment from an invoice and permanently deletes the file. |
Get InvoiceGetInvoice | GET | Retrieves an invoice by invoice ID. |
List InvoicesListInvoices | GET | Returns a list of invoices for a given location. |
Publish InvoicePublishInvoice | POST | Publishes the specified draft invoice. |
Search InvoicesSearchInvoices | POST | Searches for invoices from a location specified in the filter. |
Update InvoiceUpdateInvoice | PUT | Updates an invoice. |
Labor27
Bulk Publish Scheduled ShiftsBulkPublishScheduledShifts | POST | Publishes 1 - 100 scheduled shifts. |
Create Break TypeCreateBreakType | POST | Creates a new BreakType. |
Create Scheduled ShiftCreateScheduledShift | POST | Creates a scheduled shift by providing draft shift details such as job ID, team member assignment, and start and end times. |
Create ShiftCreateShift | POST | Creates a new Shift. |
Create TimecardCreateTimecard | POST | Creates a new Timecard. |
Delete Break TypeDeleteBreakType | DELETE | Deletes an existing BreakType. |
Delete ShiftDeleteShift | DELETE | Deletes a Shift. |
Delete TimecardDeleteTimecard | DELETE | Deletes a Timecard. |
Get Break TypeGetBreakType | GET | Returns a single BreakType specified by id. |
Get Employee WageGetEmployeeWage | GET | Returns a single EmployeeWage specified by id. |
Get ShiftGetShift | GET | Returns a single Shift specified by id. |
Get Team Member WageGetTeamMemberWage | GET | Returns a single TeamMemberWage specified by id. |
List Break TypesListBreakTypes | GET | Returns a paginated list of BreakType instances for a business. |
List Employee WagesListEmployeeWages | GET | Returns a paginated list of EmployeeWage instances for a business. |
List Team Member WagesListTeamMemberWages | GET | Returns a paginated list of TeamMemberWage instances for a business. |
List Workweek ConfigsListWorkweekConfigs | GET | Returns a list of WorkweekConfig instances for a business. |
Publish Scheduled ShiftPublishScheduledShift | POST | Publishes a scheduled shift. |
Retrieve Scheduled ShiftRetrieveScheduledShift | GET | Retrieves a scheduled shift by ID. |
Retrieve TimecardRetrieveTimecard | GET | Returns a single Timecard specified by id. |
Search Scheduled ShiftsSearchScheduledShifts | POST | Returns a paginated list of scheduled shifts, with optional filter and sort settings. |
Search ShiftsSearchShifts | POST | Returns a paginated list of Shift records for a business. |
Search TimecardsSearchTimecards | POST | Returns a paginated list of Timecard records for a business. |
Update Break TypeUpdateBreakType | PUT | Updates an existing BreakType. |
Update Scheduled ShiftUpdateScheduledShift | PUT | Updates the draft shift details for a scheduled shift. |
Update ShiftUpdateShift | PUT | Updates an existing Shift. |
Update TimecardUpdateTimecard | PUT | Updates an existing Timecard. |
Update Workweek ConfigUpdateWorkweekConfig | PUT | Updates a WorkweekConfig. |
Location4
Create LocationCreateLocation | POST | Creates a location. |
List LocationsListLocations | GET | Provides details about all of the seller's locations, including those with an inactive status. |
Retrieve LocationRetrieveLocation | GET | Retrieves details of a single location. |
Update LocationUpdateLocation | PUT | Updates a location. |
LocationCustomAttribute11
Bulk Delete Location Custom AttributesBulkDeleteLocationCustomAttributes | POST | Deletes custom attributes for locations as a bulk operation. |
Bulk Upsert Location Custom AttributesBulkUpsertLocationCustomAttributes | POST | Creates or updates custom attributes for locations as a bulk operation. |
Create Location Custom Attribute DefinitionCreateLocationCustomAttributeDefinition | POST | Creates a location-related custom attribute definition for a Square seller account. |
Delete Location Custom AttributeDeleteLocationCustomAttribute | DELETE | Deletes a custom attribute associated with a location. |
Delete Location Custom Attribute DefinitionDeleteLocationCustomAttributeDefinition | DELETE | Deletes a location-related custom attribute definition from a Square seller account. |
List Location Custom Attribute DefinitionsListLocationCustomAttributeDefinitions | GET | Lists the location-related custom attribute definitions that belong to a Square seller account. |
List Location Custom AttributesListLocationCustomAttributes | GET | Lists the custom attributes associated with a location. |
Retrieve Location Custom AttributeRetrieveLocationCustomAttribute | GET | Retrieves a custom attribute associated with a location. |
Retrieve Location Custom Attribute DefinitionRetrieveLocationCustomAttributeDefinition | GET | Retrieves a location-related custom attribute definition from a Square seller account. |
Update Location Custom Attribute DefinitionUpdateLocationCustomAttributeDefinition | PUT | Updates a location-related custom attribute definition for a Square seller account. |
Upsert Location Custom AttributeUpsertLocationCustomAttribute | POST | Creates or updates a custom attribute for a location. |
Loyalty18
Accumulate Loyalty PointsAccumulateLoyaltyPoints | POST | Adds points earned from a purchase to a loyalty account. |
Adjust Loyalty PointsAdjustLoyaltyPoints | POST | Adds points to or subtracts points from a buyer's account. |
Calculate Loyalty PointsCalculateLoyaltyPoints | POST | Calculates the number of points a buyer can earn from a purchase. |
Cancel Loyalty PromotionCancelLoyaltyPromotion | POST | Cancels a loyalty promotion. |
Create Loyalty AccountCreateLoyaltyAccount | POST | Creates a loyalty account. |
Create Loyalty PromotionCreateLoyaltyPromotion | POST | Creates a loyalty promotion for a loyalty program. |
Create Loyalty RewardCreateLoyaltyReward | POST | Creates a loyalty reward. |
Delete Loyalty RewardDeleteLoyaltyReward | DELETE | Deletes a loyalty reward by doing the following: |
List Loyalty ProgramsListLoyaltyPrograms | GET | Returns a list of loyalty programs in the seller's account. |
List Loyalty PromotionsListLoyaltyPromotions | GET | Lists the loyalty promotions associated with a loyalty program. |
Redeem Loyalty RewardRedeemLoyaltyReward | POST | Redeems a loyalty reward. |
Retrieve Loyalty AccountRetrieveLoyaltyAccount | GET | Retrieves a loyalty account. |
Retrieve Loyalty ProgramRetrieveLoyaltyProgram | GET | Retrieves the loyalty program in a seller's account, specified by the program ID or the keyword main. |
Retrieve Loyalty PromotionRetrieveLoyaltyPromotion | GET | Retrieves a loyalty promotion. |
Retrieve Loyalty RewardRetrieveLoyaltyReward | GET | Retrieves a loyalty reward. |
Search Loyalty AccountsSearchLoyaltyAccounts | POST | Searches for loyalty accounts in a loyalty program. |
Search Loyalty EventsSearchLoyaltyEvents | POST | Searches for loyalty events. |
Search Loyalty RewardsSearchLoyaltyRewards | POST | Searches for loyalty rewards. |
Merchant2
List MerchantsListMerchants | GET | Provides details about the merchant associated with a given access token. |
Retrieve MerchantRetrieveMerchant | GET | Retrieves the Merchant object for the given merchant id. |
MerchantCustomAttribute11
Bulk Delete Merchant Custom AttributesBulkDeleteMerchantCustomAttributes | POST | Deletes custom attributes for a merchant as a bulk operation. |
Bulk Upsert Merchant Custom AttributesBulkUpsertMerchantCustomAttributes | POST | Creates or updates custom attributes for a merchant as a bulk operation. |
Create Merchant Custom Attribute DefinitionCreateMerchantCustomAttributeDefinition | POST | Creates a merchant-related custom attribute definition for a Square seller account. |
Delete Merchant Custom AttributeDeleteMerchantCustomAttribute | DELETE | Deletes a custom attribute associated with a merchant. |
Delete Merchant Custom Attribute DefinitionDeleteMerchantCustomAttributeDefinition | DELETE | Deletes a merchant-related custom attribute definition from a Square seller account. |
List Merchant Custom Attribute DefinitionsListMerchantCustomAttributeDefinitions | GET | Lists the merchant-related custom attribute definitions that belong to a Square seller account. |
List Merchant Custom AttributesListMerchantCustomAttributes | GET | Lists the custom attributes associated with a merchant. |
Retrieve Merchant Custom AttributeRetrieveMerchantCustomAttribute | GET | Retrieves a custom attribute associated with a merchant. |
Retrieve Merchant Custom Attribute DefinitionRetrieveMerchantCustomAttributeDefinition | GET | Retrieves a merchant-related custom attribute definition from a Square seller account. |
Update Merchant Custom Attribute DefinitionUpdateMerchantCustomAttributeDefinition | PUT | Updates a merchant-related custom attribute definition for a Square seller account. |
Upsert Merchant Custom AttributeUpsertMerchantCustomAttribute | POST | Creates or updates a custom attribute for a merchant. |
OAuth3
Obtain TokenObtainToken | POST | Returns an OAuth access token and refresh token using the authorization code or refresh token grant type. |
Retrieve Token StatusRetrieveTokenStatus | POST | Returns information about an OAuth access token or an application’s personal access token. |
Revoke TokenRevokeToken | POST | Revokes an access token generated with the OAuth flow. |
Order8
Batch Retrieve OrdersBatchRetrieveOrders | POST | Retrieves a set of orders by their IDs. |
Calculate OrderCalculateOrder | POST | Enables applications to preview order pricing without creating an order. |
Clone OrderCloneOrder | POST | Creates a new order, in the DRAFT state, by duplicating an existing order. |
Create OrderCreateOrder | POST | Creates a new order that can include information about products for purchase and settings to apply to the purchase. |
Pay OrderPayOrder | POST | Pay for an order using one or more approved payments or settle an order with a total of 0. |
Retrieve OrderRetrieveOrder | GET | Retrieves an Order by ID. |
Search OrdersSearchOrders | POST | Search all orders for one or more locations. |
Update OrderUpdateOrder | PUT | Updates an open order by adding, replacing, or deleting fields. |
OrderCustomAttribute11
Bulk Delete Order Custom AttributesBulkDeleteOrderCustomAttributes | POST | Deletes order custom attributes as a bulk operation. |
Bulk Upsert Order Custom AttributesBulkUpsertOrderCustomAttributes | POST | Creates or updates order custom attributes as a bulk operation. |
Create Order Custom Attribute DefinitionCreateOrderCustomAttributeDefinition | POST | Creates an order-related custom attribute definition. |
Delete Order Custom AttributeDeleteOrderCustomAttribute | DELETE | Deletes a custom attribute associated with a customer profile. |
Delete Order Custom Attribute DefinitionDeleteOrderCustomAttributeDefinition | DELETE | Deletes an order-related custom attribute definition from a Square seller account. |
List Order Custom Attribute DefinitionsListOrderCustomAttributeDefinitions | GET | Lists the order-related custom attribute definitions that belong to a Square seller account. |
List Order Custom AttributesListOrderCustomAttributes | GET | Lists the custom attributes associated with an order. |
Retrieve Order Custom AttributeRetrieveOrderCustomAttribute | GET | Retrieves a custom attribute associated with an order. |
Retrieve Order Custom Attribute DefinitionRetrieveOrderCustomAttributeDefinition | GET | Retrieves an order-related custom attribute definition from a Square seller account. |
Update Order Custom Attribute DefinitionUpdateOrderCustomAttributeDefinition | PUT | Updates an order-related custom attribute definition for a Square seller account. |
Upsert Order Custom AttributeUpsertOrderCustomAttribute | POST | Creates or updates a custom attribute for an order. |
Payment7
Cancel PaymentCancelPayment | POST | Cancels (voids) a payment. |
Cancel Payment By Idempotency KeyCancelPaymentByIdempotencyKey | POST | Cancels (voids) a payment identified by the idempotency key that is specified in the request. |
Complete PaymentCompletePayment | POST | Completes (captures) a payment. |
Create PaymentCreatePayment | POST | Creates a payment using the provided source. |
Get PaymentGetPayment | GET | Retrieves details for a specific payment. |
List PaymentsListPayments | GET | Retrieves a list of payments taken by the account making the request. |
Update PaymentUpdatePayment | PUT | Updates a payment with the APPROVED status. |
Payout3
Get PayoutGetPayout | GET | Retrieves details of a specific payout identified by a payout ID. |
List Payout EntriesListPayoutEntries | GET | Retrieves a list of all payout entries for a specific payout. |
List PayoutsListPayouts | GET | Retrieves a list of all payouts for the default location. |
Refund3
Get Payment RefundGetPaymentRefund | GET | Retrieves a specific refund using the refund id. |
List Payment RefundsListPaymentRefunds | GET | Retrieves a list of refunds for the account making the request. |
Refund PaymentRefundPayment | POST | Refunds a payment. |
Site1
List SitesListSites | GET | Lists the Square Online sites that belong to a seller. |
Snippet3
Delete SnippetDeleteSnippet | DELETE | Removes your snippet from a Square Online site. |
Retrieve SnippetRetrieveSnippet | GET | Retrieves your snippet from a Square Online site. |
Upsert SnippetUpsertSnippet | POST | Adds a snippet to a Square Online site or updates the existing snippet on the site. |
Subscription12
Bulk Swap PlanBulkSwapPlan | POST | Schedules a plan variation change for all active subscriptions under a given plan variation. |
Cancel SubscriptionCancelSubscription | POST | Schedules a CANCEL action to cancel an active subscription. |
Change Billing Anchor DateChangeBillingAnchorDate | POST | Changes the billing anchor date for a subscription. |
Create SubscriptionCreateSubscription | POST | Enrolls a customer in a subscription. |
Delete Subscription ActionDeleteSubscriptionAction | DELETE | Deletes a scheduled action for a subscription. |
List Subscription EventsListSubscriptionEvents | GET | Lists all events for a specific subscription. |
Pause SubscriptionPauseSubscription | POST | Schedules a PAUSE action to pause an active subscription. |
Resume SubscriptionResumeSubscription | POST | Schedules a RESUME action to resume a paused or a deactivated subscription. |
Retrieve SubscriptionRetrieveSubscription | GET | Retrieves a specific subscription. |
Search SubscriptionsSearchSubscriptions | POST | Searches for subscriptions. |
Swap PlanSwapPlan | POST | Schedules a SWAP PLAN action to swap a subscription plan variation in an existing subscription. |
Update SubscriptionUpdateSubscription | PUT | Updates a subscription by modifying or clearing subscription field values. |
Team12
Bulk Create Team MembersBulkCreateTeamMembers | POST | Creates multiple TeamMember objects. |
Bulk Update Team MembersBulkUpdateTeamMembers | POST | Updates multiple TeamMember objects. |
Create JobCreateJob | POST | Creates a job in a seller account. |
Create Team MemberCreateTeamMember | POST | Creates a single TeamMember object. |
List JobsListJobs | GET | Lists jobs in a seller account. |
Retrieve JobRetrieveJob | GET | Retrieves a specified job. |
Retrieve Team MemberRetrieveTeamMember | GET | Retrieves a TeamMember object for the given TeamMember.id. |
Retrieve Wage SettingRetrieveWageSetting | GET | Retrieves a WageSetting object for a team member specified by TeamMember.id. |
Search Team MembersSearchTeamMembers | POST | Returns a paginated list of TeamMember objects for a business. |
Update JobUpdateJob | PUT | Updates the title or tip eligibility of a job. |
Update Team MemberUpdateTeamMember | PUT | Updates a single TeamMember object. |
Update Wage SettingUpdateWageSetting | PUT | Creates or updates a WageSetting object. |
Terminal15
Cancel Terminal ActionCancelTerminalAction | POST | Cancels a Terminal action request if the status of the request permits it. |
Cancel Terminal CheckoutCancelTerminalCheckout | POST | Cancels a Terminal checkout request if the status of the request permits it. |
Cancel Terminal RefundCancelTerminalRefund | POST | Cancels an Interac Terminal refund request by refund request ID if the status of the request permits it. |
Create Terminal ActionCreateTerminalAction | POST | Creates a Terminal action request and sends it to the specified device. |
Create Terminal CheckoutCreateTerminalCheckout | POST | Creates a Terminal checkout request and sends it to the specified device to take a payment for the requested amount. |
Create Terminal RefundCreateTerminalRefund | POST | Creates a request to refund an Interac payment completed on a Square Terminal. |
Dismiss Terminal ActionDismissTerminalAction | POST | Dismisses a Terminal action request if the status and type of the request permits it. |
Dismiss Terminal CheckoutDismissTerminalCheckout | POST | Dismisses a Terminal checkout request if the status and type of the request permits it. |
Dismiss Terminal RefundDismissTerminalRefund | POST | Dismisses a Terminal refund request if the status and type of the request permits it. |
Get Terminal ActionGetTerminalAction | GET | Retrieves a Terminal action request by action id. |
Get Terminal CheckoutGetTerminalCheckout | GET | Retrieves a Terminal checkout request by checkout id. |
Get Terminal RefundGetTerminalRefund | GET | Retrieves an Interac Terminal refund object by ID. |
Search Terminal ActionsSearchTerminalActions | POST | Retrieves a filtered list of Terminal action requests created by the account making the request. |
Search Terminal CheckoutsSearchTerminalCheckouts | POST | Returns a filtered list of Terminal checkout requests created by the application making the request. |
Search Terminal RefundsSearchTerminalRefunds | POST | Retrieves a filtered list of Interac Terminal refund requests created by the seller making the request. |
Transaction4
Capture TransactionCaptureTransaction | POST | Captures a transaction that was created with the Charge endpoint with a delay capture value of true. |
List TransactionsListTransactions | GET | Lists transactions for a particular location. |
Retrieve TransactionRetrieveTransaction | GET | Retrieves details for a single transaction. |
Void TransactionVoidTransaction | POST | Cancels a transaction that was created with the Charge endpoint with a delay capture value of true. |
TransferOrder8
Cancel Transfer OrderCancelTransferOrder | POST | Cancels a transfer order in STARTED or PARTIALLY RECEIVED status. |
Create Transfer OrderCreateTransferOrder | POST | Creates a new transfer order in DRAFT status. |
Delete Transfer OrderDeleteTransferOrder | DELETE | Deletes a transfer order in DRAFT status. |
Receive Transfer OrderReceiveTransferOrder | POST | Records receipt of CatalogItemVariations for a transfer order. |
Retrieve Transfer OrderRetrieveTransferOrder | GET | Retrieves a specific TransferOrder by ID. |
Search Transfer OrdersSearchTransferOrders | POST | Searches for transfer orders using filters. |
Start Transfer OrderStartTransferOrder | POST | Changes a DRAFT transfer order to STARTED status. |
Update Transfer OrderUpdateTransferOrder | PUT | Updates an existing transfer order. |
V1Transaction3
V 1 List OrdersV1ListOrders | GET | Provides summary information for a merchant's online store orders. |
V 1 Retrieve OrderV1RetrieveOrder | GET | Provides comprehensive information for a single online store order, including the order's history. |
V 1 Update OrderV1UpdateOrder | PUT | Updates the details of an online store order. |
Vendor7
Bulk Create VendorsBulkCreateVendors | POST | Creates one or more Vendor objects to represent suppliers to a seller. |
Bulk Retrieve VendorsBulkRetrieveVendors | POST | Retrieves one or more vendors of specified Vendor IDs. |
Bulk Update VendorsBulkUpdateVendors | PUT | Updates one or more of existing Vendor objects as suppliers to a seller. |
Create VendorCreateVendor | POST | Creates a single Vendor object to represent a supplier to a seller. |
Retrieve VendorRetrieveVendor | GET | Retrieves the vendor of a specified Vendor ID. |
Search VendorsSearchVendors | POST | Searches for vendors using a filter against supported Vendor properties and a supported sorter. |
Update VendorUpdateVendor | PUT | Updates an existing Vendor object as a supplier to a seller. |
WebhookSubscription8
Create Webhook SubscriptionCreateWebhookSubscription | POST | Creates a webhook subscription. |
Delete Webhook SubscriptionDeleteWebhookSubscription | DELETE | Deletes a webhook subscription. |
List Webhook Event TypesListWebhookEventTypes | GET | Lists all webhook event types that can be subscribed to. |
List Webhook SubscriptionsListWebhookSubscriptions | GET | Lists all webhook subscriptions owned by your application. |
Retrieve Webhook SubscriptionRetrieveWebhookSubscription | GET | Retrieves a webhook subscription identified by its ID. |
Test Webhook SubscriptionTestWebhookSubscription | POST | Tests a webhook subscription by sending a test event to the notification URL. |
Update Webhook SubscriptionUpdateWebhookSubscription | PUT | Updates a webhook subscription. |
Update Webhook Subscription Signature KeyUpdateWebhookSubscriptionSignatureKey | POST | Updates a webhook subscription by replacing the existing signature key with a new one. |