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

  1. In Neblex open Connect › Connections and click New Connection.
  2. Search for Square and give the connection a clear name.
  3. Fill in the fields. Secret values are encrypted and never shown again.
  4. Click Test, then Create Connection.
FieldWhat 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.

EventWhat it doesHow
New or updated bankaccountFires for each bankaccount that appears or changes since the last check.Checks for changes
New or updated bookingFires for each booking that appears or changes since the last check.Checks for changes
New or updated laborFires for each labor that appears or changes since the last check.Checks for changes
New or updated cardFires for each card that appears or changes since the last check.Checks for changes
New or updated catalogFires for each catalog that appears or changes since the last check.Checks for changes
New or updated channelFires for each channel that appears or changes since the last check.Checks for changes
New or updated customergroupFires for each customergroup that appears or changes since the last check.Checks for changes
New or updated customerFires for each customer that appears or changes since the last check.Checks for changes
New or updated deviceFires for each device that appears or changes since the last check.Checks for changes
New or updated disputeFires for each dispute that appears or changes since the last check.Checks for changes
New or updated giftcardactivityFires for each giftcardactivity that appears or changes since the last check.Checks for changes
New or updated giftcardFires for each giftcard that appears or changes since the last check.Checks for changes
New or updated invoiceFires for each invoice that appears or changes since the last check.Checks for changes
New or updated teamFires for each team that appears or changes since the last check.Checks for changes
New or updated loyaltyFires for each loyalty that appears or changes since the last check.Checks for changes
New or updated checkoutFires for each checkout that appears or changes since the last check.Checks for changes
New or updated refundFires for each refund that appears or changes since the last check.Checks for changes
New or updated paymentFires for each payment that appears or changes since the last check.Checks for changes
New or updated subscriptionFires for each subscription that appears or changes since the last check.Checks for changes
New or updated transactionFires for each transaction that appears or changes since the last check.Checks for changes
New or updated webhooksubscriptionFires for each webhooksubscription that appears or changes since the last check.Checks for changes
New bankaccountFires for each bankaccount that appears since the last check.Checks for changes
New bookingFires for each booking that appears since the last check.Checks for changes
New laborFires for each labor that appears since the last check.Checks for changes
New cardFires for each card that appears since the last check.Checks for changes
New catalogFires for each catalog that appears since the last check.Checks for changes
New channelFires for each channel that appears since the last check.Checks for changes
New customergroupFires for each customergroup that appears since the last check.Checks for changes
New customerFires for each customer that appears since the last check.Checks for changes
New deviceFires for each device that appears since the last check.Checks for changes
New disputeFires for each dispute that appears since the last check.Checks for changes
New giftcardactivityFires for each giftcardactivity that appears since the last check.Checks for changes
New giftcardFires for each giftcard that appears since the last check.Checks for changes
New invoiceFires for each invoice that appears since the last check.Checks for changes
New teamFires for each team that appears since the last check.Checks for changes
New loyaltyFires for each loyalty that appears since the last check.Checks for changes
New checkoutFires for each checkout that appears since the last check.Checks for changes
New refundFires for each refund that appears since the last check.Checks for changes
New paymentFires for each payment that appears since the last check.Checks for changes
New subscriptionFires for each subscription that appears since the last check.Checks for changes
New transactionFires for each transaction that appears since the last check.Checks for changes
New webhooksubscriptionFires for each webhooksubscription that appears since the last check.Checks for changes

Use it in a flow

  1. Open a flow, open the node library and search for Square.
  2. Drag it onto the canvas and choose an Operation and your connection.
  3. Map the operation's fields from earlier steps, or click Map with Matt.
  4. 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 DomainRegisterDomainPOSTActivates a domain for use with Apple Pay on the Web and Square.
BankAccount5
Create Bank AccountCreateBankAccountPOSTStore a bank account on file for a square account
Disable Bank AccountDisableBankAccountPOSTDisable a bank account.
Get Bank AccountGetBankAccountGETRetrieve details of a BankAccount bank account linked to a Square account.
Get Bank Account By V 1 IdGetBankAccountByV1IdGETReturns details of a BankAccount identified by V1 bank account ID.
List Bank AccountsListBankAccountsGETReturns a list of BankAccount objects linked to a Square account.
Booking13
Bulk Retrieve BookingsBulkRetrieveBookingsPOSTBulk-Retrieves a list of bookings by booking IDs.
Bulk Retrieve Team Member Booking ProfilesBulkRetrieveTeamMemberBookingProfilesPOSTRetrieves one or more team members' booking profiles.
Cancel BookingCancelBookingPOSTCancels an existing booking.
Create BookingCreateBookingPOSTCreates a booking.
List BookingsListBookingsGETRetrieve a collection of bookings.
List Location Booking ProfilesListLocationBookingProfilesGETLists location booking profiles of a seller.
List Team Member Booking ProfilesListTeamMemberBookingProfilesGETLists booking profiles for team members.
Retrieve BookingRetrieveBookingGETRetrieves a booking.
Retrieve Business Booking ProfileRetrieveBusinessBookingProfileGETRetrieves a seller's booking profile.
Retrieve Location Booking ProfileRetrieveLocationBookingProfileGETRetrieves a seller's location booking profile.
Retrieve Team Member Booking ProfileRetrieveTeamMemberBookingProfileGETRetrieves a team member's booking profile.
Search AvailabilitySearchAvailabilityPOSTSearches for availabilities for booking.
Update BookingUpdateBookingPUTUpdates a booking.
BookingCustomAttribute11
Bulk Delete Booking Custom AttributesBulkDeleteBookingCustomAttributesPOSTBulk deletes bookings custom attributes.
Bulk Upsert Booking Custom AttributesBulkUpsertBookingCustomAttributesPOSTBulk upserts bookings custom attributes.
Create Booking Custom Attribute DefinitionCreateBookingCustomAttributeDefinitionPOSTCreates a bookings custom attribute definition.
Delete Booking Custom AttributeDeleteBookingCustomAttributeDELETEDeletes a bookings custom attribute.
Delete Booking Custom Attribute DefinitionDeleteBookingCustomAttributeDefinitionDELETEDeletes a bookings custom attribute definition.
List Booking Custom Attribute DefinitionsListBookingCustomAttributeDefinitionsGETGet all bookings custom attribute definitions.
List Booking Custom AttributesListBookingCustomAttributesGETLists a booking's custom attributes.
Retrieve Booking Custom AttributeRetrieveBookingCustomAttributeGETRetrieves a bookings custom attribute.
Retrieve Booking Custom Attribute DefinitionRetrieveBookingCustomAttributeDefinitionGETRetrieves a bookings custom attribute definition.
Update Booking Custom Attribute DefinitionUpdateBookingCustomAttributeDefinitionPUTUpdates a bookings custom attribute definition.
Upsert Booking Custom AttributeUpsertBookingCustomAttributePUTUpserts a bookings custom attribute.
Card4
Create CardCreateCardPOSTAdds a card on file to an existing merchant.
Disable CardDisableCardPOSTDisables the card, preventing any further updates or charges.
List CardsListCardsGETRetrieves a list of cards owned by the account making the request.
Retrieve CardRetrieveCardGETRetrieves details for a specific Card.
CashDrawer3
List Cash Drawer Shift EventsListCashDrawerShiftEventsGETProvides a paginated list of events for a single cash drawer shift.
List Cash Drawer ShiftsListCashDrawerShiftsGETProvides the details for all of the cash drawer shifts for a location in a date range.
Retrieve Cash Drawer ShiftRetrieveCashDrawerShiftGETProvides the summary details for a single cash drawer shift.
Catalog14
Batch Delete Catalog ObjectsBatchDeleteCatalogObjectsPOSTDeletes 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 ObjectsBatchRetrieveCatalogObjectsPOSTReturns a set of objects based on the provided ID.
Batch Upsert Catalog ObjectsBatchUpsertCatalogObjectsPOSTCreates or updates up to 10,000 target objects based on the provided list of objects.
Catalog InfoCatalogInfoGETRetrieves information about the Square Catalog API, such as batch size limits that can be used by the BatchUpsertCatalogObjects endpoint.
Create Catalog ImageCreateCatalogImagePOSTUploads an image file to be represented by a CatalogImage object that can be linked to an existing CatalogObject instance.
Delete Catalog ObjectDeleteCatalogObjectDELETEDeletes a single CatalogObject based on the provided ID and returns the set of successfully deleted IDs in the response.
List CatalogListCatalogGETReturns a list of all CatalogObjects of the specified types in the catalog.
Retrieve Catalog ObjectRetrieveCatalogObjectGETReturns a single CatalogItem as a CatalogObject based on the provided ID.
Search Catalog ItemsSearchCatalogItemsPOSTSearches 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 ObjectsSearchCatalogObjectsPOSTSearches 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 ImageUpdateCatalogImagePUTUploads a new image file to replace the existing one in the specified CatalogImage object.
Update Item Modifier ListsUpdateItemModifierListsPOSTUpdates the CatalogModifierList objects that apply to the targeted CatalogItem without having to perform an upsert on the entire item.
Update Item TaxesUpdateItemTaxesPOSTUpdates the CatalogTax objects that apply to the targeted CatalogItem without having to perform an upsert on the entire item.
Upsert Catalog ObjectUpsertCatalogObjectPOSTCreates a new or updates the specified CatalogObject.
Channel3
Bulk Retrieve ChannelsBulkRetrieveChannelsPOST
List ChannelsListChannelsGET
Retrieve ChannelRetrieveChannelGET
Checkout10
Create CheckoutCreateCheckoutPOSTLinks 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 LinkCreatePaymentLinkPOSTCreates a Square-hosted checkout page.
Delete Payment LinkDeletePaymentLinkDELETEDeletes a payment link.
List Payment LinksListPaymentLinksGETLists all payment links.
Retrieve Location SettingsRetrieveLocationSettingsGETRetrieves the location-level settings for a Square-hosted checkout page.
Retrieve Merchant SettingsRetrieveMerchantSettingsGETRetrieves the merchant-level settings for a Square-hosted checkout page.
Retrieve Payment LinkRetrievePaymentLinkGETRetrieves a payment link.
Update Location SettingsUpdateLocationSettingsPUTUpdates the location-level settings for a Square-hosted checkout page.
Update Merchant SettingsUpdateMerchantSettingsPUTUpdates the merchant-level settings for a Square-hosted checkout page.
Update Payment LinkUpdatePaymentLinkPUTUpdates a payment link.
Customer14
Add Group To CustomerAddGroupToCustomerPUTAdds a group membership to a customer.
Bulk Create CustomersBulkCreateCustomersPOSTCreates multiple customer profiles for a business.
Bulk Delete CustomersBulkDeleteCustomersPOSTDeletes multiple customer profiles.
Bulk Retrieve CustomersBulkRetrieveCustomersPOSTRetrieves multiple customer profiles.
Bulk Update CustomersBulkUpdateCustomersPOSTUpdates multiple customer profiles.
Create CustomerCreateCustomerPOSTCreates a new customer for a business.
Create Customer CardCreateCustomerCardPOSTAdds a card on file to an existing customer.
Delete CustomerDeleteCustomerDELETEDeletes a customer profile from a business.
Delete Customer CardDeleteCustomerCardDELETERemoves a card on file from a customer.
List CustomersListCustomersGETLists customer profiles associated with a Square account.
Remove Group From CustomerRemoveGroupFromCustomerDELETERemoves a group membership from a customer.
Retrieve CustomerRetrieveCustomerGETReturns details for a single customer.
Search CustomersSearchCustomersPOSTSearches the customer profiles associated with a Square account using one or more supported query filters.
Update CustomerUpdateCustomerPUTUpdates a customer profile.
CustomerCustomAttribute10
Bulk Upsert Customer Custom AttributesBulkUpsertCustomerCustomAttributesPOSTCreates or updates custom attributes for customer profiles as a bulk operation.
Create Customer Custom Attribute DefinitionCreateCustomerCustomAttributeDefinitionPOSTCreates a customer-related custom attribute definition for a Square seller account.
Delete Customer Custom AttributeDeleteCustomerCustomAttributeDELETEDeletes a custom attribute associated with a customer profile.
Delete Customer Custom Attribute DefinitionDeleteCustomerCustomAttributeDefinitionDELETEDeletes a customer-related custom attribute definition from a Square seller account.
List Customer Custom Attribute DefinitionsListCustomerCustomAttributeDefinitionsGETLists the customer-related custom attribute definitions that belong to a Square seller account.
List Customer Custom AttributesListCustomerCustomAttributesGETLists the custom attributes associated with a customer profile.
Retrieve Customer Custom AttributeRetrieveCustomerCustomAttributeGETRetrieves a custom attribute associated with a customer profile.
Retrieve Customer Custom Attribute DefinitionRetrieveCustomerCustomAttributeDefinitionGETRetrieves a customer-related custom attribute definition from a Square seller account.
Update Customer Custom Attribute DefinitionUpdateCustomerCustomAttributeDefinitionPUTUpdates a customer-related custom attribute definition for a Square seller account.
Upsert Customer Custom AttributeUpsertCustomerCustomAttributePOSTCreates or updates a custom attribute for a customer profile.
CustomerGroup5
Create Customer GroupCreateCustomerGroupPOSTCreates a new customer group for a business.
Delete Customer GroupDeleteCustomerGroupDELETEDeletes a customer group as identified by the group id value.
List Customer GroupsListCustomerGroupsGETRetrieves the list of customer groups of a business.
Retrieve Customer GroupRetrieveCustomerGroupGETRetrieves a specific customer group as identified by the group id value.
Update Customer GroupUpdateCustomerGroupPUTUpdates a customer group as identified by the group id value.
CustomerSegment2
List Customer SegmentsListCustomerSegmentsGETRetrieves the list of customer segments of a business.
Retrieve Customer SegmentRetrieveCustomerSegmentGETRetrieves a specific customer segment as identified by the segment id value.
Device5
Create Device CodeCreateDeviceCodePOSTCreates a DeviceCode that can be used to login to a Square Terminal device to enter the connected terminal mode.
Get DeviceGetDeviceGETRetrieves Device with the associated device id.
Get Device CodeGetDeviceCodeGETRetrieves DeviceCode with the associated ID.
List Device CodesListDeviceCodesGETLists all DeviceCodes associated with the merchant.
List DevicesListDevicesGETList devices associated with the merchant.
Dispute9
Accept DisputeAcceptDisputePOSTAccepts the loss on a dispute.
Create Dispute Evidence FileCreateDisputeEvidenceFilePOSTUploads a file to use as evidence in a dispute challenge.
Create Dispute Evidence TextCreateDisputeEvidenceTextPOSTUploads text to use as evidence for a dispute challenge.
Delete Dispute EvidenceDeleteDisputeEvidenceDELETERemoves specified evidence from a dispute.
List Dispute EvidenceListDisputeEvidenceGETReturns a list of evidence associated with a dispute.
List DisputesListDisputesGETReturns a list of disputes associated with a particular account.
Retrieve DisputeRetrieveDisputeGETReturns details about a specific dispute.
Retrieve Dispute EvidenceRetrieveDisputeEvidenceGETReturns the metadata for the evidence specified in the request URL path.
Submit EvidenceSubmitEvidencePOSTSubmits evidence to the cardholder's bank.
Employee2
List EmployeesListEmployeesGET
Retrieve EmployeeRetrieveEmployeeGET
Event4
Disable EventsDisableEventsPUTDisables events to prevent them from being searchable.
Enable EventsEnableEventsPUTEnables events to make them searchable.
List Event TypesListEventTypesGETLists all event types that you can subscribe to as webhooks or query using the Events API.
Search EventsSearchEventsPOSTSearch for Square API events that occur within a 28-day timeframe.
GiftCard7
Create Gift CardCreateGiftCardPOSTCreates a digital gift card or registers a physical (plastic) gift card.
Link Customer To Gift CardLinkCustomerToGiftCardPOSTLinks a customer to a gift card, which is also referred to as adding a card on file.
List Gift CardsListGiftCardsGETLists all gift cards.
Retrieve Gift CardRetrieveGiftCardGETRetrieves a gift card using the gift card ID.
Retrieve Gift Card From GANRetrieveGiftCardFromGANPOSTRetrieves a gift card using the gift card account number (GAN).
Retrieve Gift Card From NonceRetrieveGiftCardFromNoncePOSTRetrieves a gift card using a secure payment token that represents the gift card.
Unlink Customer From Gift CardUnlinkCustomerFromGiftCardPOSTUnlinks a customer from a gift card, which is also referred to as removing a card on file.
GiftCardActivity2
Create Gift Card ActivityCreateGiftCardActivityPOSTCreates a gift card activity to manage the balance or state of a gift card.
List Gift Card ActivitiesListGiftCardActivitiesGETLists gift card activities.
Inventory19
Batch Change InventoryBatchChangeInventoryPOSTApplies adjustments and counts to the provided item quantities.
Batch Retrieve Inventory ChangesBatchRetrieveInventoryChangesPOSTReturns historical physical counts and adjustments based on the provided filter criteria.
Batch Retrieve Inventory CountsBatchRetrieveInventoryCountsPOSTReturns current counts for the provided CatalogObjects at the requested Locations.
Create Inventory Adjustment ReasonCreateInventoryAdjustmentReasonPOSTCreates a custom inventory adjustment reason.
Delete Inventory Adjustment ReasonDeleteInventoryAdjustmentReasonPOSTSoft deletes a custom inventory adjustment reason.
Deprecated Batch Change InventoryDeprecatedBatchChangeInventoryPOSTDeprecated version of BatchChangeInventory after the endpoint URL is updated to conform to the standard convention.
Deprecated Batch Retrieve Inventory ChangesDeprecatedBatchRetrieveInventoryChangesPOSTDeprecated version of BatchRetrieveInventoryChanges after the endpoint URL is updated to conform to the standard convention.
Deprecated Batch Retrieve Inventory CountsDeprecatedBatchRetrieveInventoryCountsPOSTDeprecated version of BatchRetrieveInventoryCounts after the endpoint URL is updated to conform to the standard convention.
Deprecated Retrieve Inventory AdjustmentDeprecatedRetrieveInventoryAdjustmentGETDeprecated version of RetrieveInventoryAdjustment after the endpoint URL is updated to conform to the standard convention.
Deprecated Retrieve Inventory Physical CountDeprecatedRetrieveInventoryPhysicalCountGETDeprecated version of RetrieveInventoryPhysicalCount after the endpoint URL is updated to conform to the standard convention.
List Inventory Adjustment ReasonsListInventoryAdjustmentReasonsGETReturns the standard and custom inventory adjustment reasons available to the seller.
Restore Inventory Adjustment ReasonRestoreInventoryAdjustmentReasonPOSTRestores a soft-deleted custom inventory adjustment reason.
Retrieve Inventory AdjustmentRetrieveInventoryAdjustmentGETReturns the InventoryAdjustment object with the provided adjustment id.
Retrieve Inventory Adjustment ReasonRetrieveInventoryAdjustmentReasonPOSTReturns the inventory adjustment reason identified by the provided reason id.
Retrieve Inventory ChangesRetrieveInventoryChangesGETReturns a set of physical counts and inventory adjustments for the provided CatalogObject at the requested Locations.
Retrieve Inventory CountRetrieveInventoryCountGETRetrieves the current calculated stock count for a given CatalogObject at a given set of Locations.
Retrieve Inventory Physical CountRetrieveInventoryPhysicalCountGETReturns the InventoryPhysicalCount object with the provided physical count id.
Update Inventory AdjustmentUpdateInventoryAdjustmentPUTApplies an update to the provided adjustment.
Update Inventory Adjustment ReasonUpdateInventoryAdjustmentReasonPUTUpdates a custom inventory adjustment reason.
Invoice10
Cancel InvoiceCancelInvoicePOSTCancels an invoice.
Create InvoiceCreateInvoicePOSTCreates a draft invoice for an order created using the Orders API.
Create Invoice AttachmentCreateInvoiceAttachmentPOSTUploads a file and attaches it to an invoice.
Delete InvoiceDeleteInvoiceDELETEDeletes the specified invoice.
Delete Invoice AttachmentDeleteInvoiceAttachmentDELETERemoves an attachment from an invoice and permanently deletes the file.
Get InvoiceGetInvoiceGETRetrieves an invoice by invoice ID.
List InvoicesListInvoicesGETReturns a list of invoices for a given location.
Publish InvoicePublishInvoicePOSTPublishes the specified draft invoice.
Search InvoicesSearchInvoicesPOSTSearches for invoices from a location specified in the filter.
Update InvoiceUpdateInvoicePUTUpdates an invoice.
Labor27
Bulk Publish Scheduled ShiftsBulkPublishScheduledShiftsPOSTPublishes 1 - 100 scheduled shifts.
Create Break TypeCreateBreakTypePOSTCreates a new BreakType.
Create Scheduled ShiftCreateScheduledShiftPOSTCreates a scheduled shift by providing draft shift details such as job ID, team member assignment, and start and end times.
Create ShiftCreateShiftPOSTCreates a new Shift.
Create TimecardCreateTimecardPOSTCreates a new Timecard.
Delete Break TypeDeleteBreakTypeDELETEDeletes an existing BreakType.
Delete ShiftDeleteShiftDELETEDeletes a Shift.
Delete TimecardDeleteTimecardDELETEDeletes a Timecard.
Get Break TypeGetBreakTypeGETReturns a single BreakType specified by id.
Get Employee WageGetEmployeeWageGETReturns a single EmployeeWage specified by id.
Get ShiftGetShiftGETReturns a single Shift specified by id.
Get Team Member WageGetTeamMemberWageGETReturns a single TeamMemberWage specified by id.
List Break TypesListBreakTypesGETReturns a paginated list of BreakType instances for a business.
List Employee WagesListEmployeeWagesGETReturns a paginated list of EmployeeWage instances for a business.
List Team Member WagesListTeamMemberWagesGETReturns a paginated list of TeamMemberWage instances for a business.
List Workweek ConfigsListWorkweekConfigsGETReturns a list of WorkweekConfig instances for a business.
Publish Scheduled ShiftPublishScheduledShiftPOSTPublishes a scheduled shift.
Retrieve Scheduled ShiftRetrieveScheduledShiftGETRetrieves a scheduled shift by ID.
Retrieve TimecardRetrieveTimecardGETReturns a single Timecard specified by id.
Search Scheduled ShiftsSearchScheduledShiftsPOSTReturns a paginated list of scheduled shifts, with optional filter and sort settings.
Search ShiftsSearchShiftsPOSTReturns a paginated list of Shift records for a business.
Search TimecardsSearchTimecardsPOSTReturns a paginated list of Timecard records for a business.
Update Break TypeUpdateBreakTypePUTUpdates an existing BreakType.
Update Scheduled ShiftUpdateScheduledShiftPUTUpdates the draft shift details for a scheduled shift.
Update ShiftUpdateShiftPUTUpdates an existing Shift.
Update TimecardUpdateTimecardPUTUpdates an existing Timecard.
Update Workweek ConfigUpdateWorkweekConfigPUTUpdates a WorkweekConfig.
Location4
Create LocationCreateLocationPOSTCreates a location.
List LocationsListLocationsGETProvides details about all of the seller's locations, including those with an inactive status.
Retrieve LocationRetrieveLocationGETRetrieves details of a single location.
Update LocationUpdateLocationPUTUpdates a location.
LocationCustomAttribute11
Bulk Delete Location Custom AttributesBulkDeleteLocationCustomAttributesPOSTDeletes custom attributes for locations as a bulk operation.
Bulk Upsert Location Custom AttributesBulkUpsertLocationCustomAttributesPOSTCreates or updates custom attributes for locations as a bulk operation.
Create Location Custom Attribute DefinitionCreateLocationCustomAttributeDefinitionPOSTCreates a location-related custom attribute definition for a Square seller account.
Delete Location Custom AttributeDeleteLocationCustomAttributeDELETEDeletes a custom attribute associated with a location.
Delete Location Custom Attribute DefinitionDeleteLocationCustomAttributeDefinitionDELETEDeletes a location-related custom attribute definition from a Square seller account.
List Location Custom Attribute DefinitionsListLocationCustomAttributeDefinitionsGETLists the location-related custom attribute definitions that belong to a Square seller account.
List Location Custom AttributesListLocationCustomAttributesGETLists the custom attributes associated with a location.
Retrieve Location Custom AttributeRetrieveLocationCustomAttributeGETRetrieves a custom attribute associated with a location.
Retrieve Location Custom Attribute DefinitionRetrieveLocationCustomAttributeDefinitionGETRetrieves a location-related custom attribute definition from a Square seller account.
Update Location Custom Attribute DefinitionUpdateLocationCustomAttributeDefinitionPUTUpdates a location-related custom attribute definition for a Square seller account.
Upsert Location Custom AttributeUpsertLocationCustomAttributePOSTCreates or updates a custom attribute for a location.
Loyalty18
Accumulate Loyalty PointsAccumulateLoyaltyPointsPOSTAdds points earned from a purchase to a loyalty account.
Adjust Loyalty PointsAdjustLoyaltyPointsPOSTAdds points to or subtracts points from a buyer's account.
Calculate Loyalty PointsCalculateLoyaltyPointsPOSTCalculates the number of points a buyer can earn from a purchase.
Cancel Loyalty PromotionCancelLoyaltyPromotionPOSTCancels a loyalty promotion.
Create Loyalty AccountCreateLoyaltyAccountPOSTCreates a loyalty account.
Create Loyalty PromotionCreateLoyaltyPromotionPOSTCreates a loyalty promotion for a loyalty program.
Create Loyalty RewardCreateLoyaltyRewardPOSTCreates a loyalty reward.
Delete Loyalty RewardDeleteLoyaltyRewardDELETEDeletes a loyalty reward by doing the following:
List Loyalty ProgramsListLoyaltyProgramsGETReturns a list of loyalty programs in the seller's account.
List Loyalty PromotionsListLoyaltyPromotionsGETLists the loyalty promotions associated with a loyalty program.
Redeem Loyalty RewardRedeemLoyaltyRewardPOSTRedeems a loyalty reward.
Retrieve Loyalty AccountRetrieveLoyaltyAccountGETRetrieves a loyalty account.
Retrieve Loyalty ProgramRetrieveLoyaltyProgramGETRetrieves the loyalty program in a seller's account, specified by the program ID or the keyword main.
Retrieve Loyalty PromotionRetrieveLoyaltyPromotionGETRetrieves a loyalty promotion.
Retrieve Loyalty RewardRetrieveLoyaltyRewardGETRetrieves a loyalty reward.
Search Loyalty AccountsSearchLoyaltyAccountsPOSTSearches for loyalty accounts in a loyalty program.
Search Loyalty EventsSearchLoyaltyEventsPOSTSearches for loyalty events.
Search Loyalty RewardsSearchLoyaltyRewardsPOSTSearches for loyalty rewards.
Merchant2
List MerchantsListMerchantsGETProvides details about the merchant associated with a given access token.
Retrieve MerchantRetrieveMerchantGETRetrieves the Merchant object for the given merchant id.
MerchantCustomAttribute11
Bulk Delete Merchant Custom AttributesBulkDeleteMerchantCustomAttributesPOSTDeletes custom attributes for a merchant as a bulk operation.
Bulk Upsert Merchant Custom AttributesBulkUpsertMerchantCustomAttributesPOSTCreates or updates custom attributes for a merchant as a bulk operation.
Create Merchant Custom Attribute DefinitionCreateMerchantCustomAttributeDefinitionPOSTCreates a merchant-related custom attribute definition for a Square seller account.
Delete Merchant Custom AttributeDeleteMerchantCustomAttributeDELETEDeletes a custom attribute associated with a merchant.
Delete Merchant Custom Attribute DefinitionDeleteMerchantCustomAttributeDefinitionDELETEDeletes a merchant-related custom attribute definition from a Square seller account.
List Merchant Custom Attribute DefinitionsListMerchantCustomAttributeDefinitionsGETLists the merchant-related custom attribute definitions that belong to a Square seller account.
List Merchant Custom AttributesListMerchantCustomAttributesGETLists the custom attributes associated with a merchant.
Retrieve Merchant Custom AttributeRetrieveMerchantCustomAttributeGETRetrieves a custom attribute associated with a merchant.
Retrieve Merchant Custom Attribute DefinitionRetrieveMerchantCustomAttributeDefinitionGETRetrieves a merchant-related custom attribute definition from a Square seller account.
Update Merchant Custom Attribute DefinitionUpdateMerchantCustomAttributeDefinitionPUTUpdates a merchant-related custom attribute definition for a Square seller account.
Upsert Merchant Custom AttributeUpsertMerchantCustomAttributePOSTCreates or updates a custom attribute for a merchant.
OAuth3
Obtain TokenObtainTokenPOSTReturns an OAuth access token and refresh token using the authorization code or refresh token grant type.
Retrieve Token StatusRetrieveTokenStatusPOSTReturns information about an OAuth access token or an application’s personal access token.
Revoke TokenRevokeTokenPOSTRevokes an access token generated with the OAuth flow.
Order8
Batch Retrieve OrdersBatchRetrieveOrdersPOSTRetrieves a set of orders by their IDs.
Calculate OrderCalculateOrderPOSTEnables applications to preview order pricing without creating an order.
Clone OrderCloneOrderPOSTCreates a new order, in the DRAFT state, by duplicating an existing order.
Create OrderCreateOrderPOSTCreates a new order that can include information about products for purchase and settings to apply to the purchase.
Pay OrderPayOrderPOSTPay for an order using one or more approved payments or settle an order with a total of 0.
Retrieve OrderRetrieveOrderGETRetrieves an Order by ID.
Search OrdersSearchOrdersPOSTSearch all orders for one or more locations.
Update OrderUpdateOrderPUTUpdates an open order by adding, replacing, or deleting fields.
OrderCustomAttribute11
Bulk Delete Order Custom AttributesBulkDeleteOrderCustomAttributesPOSTDeletes order custom attributes as a bulk operation.
Bulk Upsert Order Custom AttributesBulkUpsertOrderCustomAttributesPOSTCreates or updates order custom attributes as a bulk operation.
Create Order Custom Attribute DefinitionCreateOrderCustomAttributeDefinitionPOSTCreates an order-related custom attribute definition.
Delete Order Custom AttributeDeleteOrderCustomAttributeDELETEDeletes a custom attribute associated with a customer profile.
Delete Order Custom Attribute DefinitionDeleteOrderCustomAttributeDefinitionDELETEDeletes an order-related custom attribute definition from a Square seller account.
List Order Custom Attribute DefinitionsListOrderCustomAttributeDefinitionsGETLists the order-related custom attribute definitions that belong to a Square seller account.
List Order Custom AttributesListOrderCustomAttributesGETLists the custom attributes associated with an order.
Retrieve Order Custom AttributeRetrieveOrderCustomAttributeGETRetrieves a custom attribute associated with an order.
Retrieve Order Custom Attribute DefinitionRetrieveOrderCustomAttributeDefinitionGETRetrieves an order-related custom attribute definition from a Square seller account.
Update Order Custom Attribute DefinitionUpdateOrderCustomAttributeDefinitionPUTUpdates an order-related custom attribute definition for a Square seller account.
Upsert Order Custom AttributeUpsertOrderCustomAttributePOSTCreates or updates a custom attribute for an order.
Payment7
Cancel PaymentCancelPaymentPOSTCancels (voids) a payment.
Cancel Payment By Idempotency KeyCancelPaymentByIdempotencyKeyPOSTCancels (voids) a payment identified by the idempotency key that is specified in the request.
Complete PaymentCompletePaymentPOSTCompletes (captures) a payment.
Create PaymentCreatePaymentPOSTCreates a payment using the provided source.
Get PaymentGetPaymentGETRetrieves details for a specific payment.
List PaymentsListPaymentsGETRetrieves a list of payments taken by the account making the request.
Update PaymentUpdatePaymentPUTUpdates a payment with the APPROVED status.
Payout3
Get PayoutGetPayoutGETRetrieves details of a specific payout identified by a payout ID.
List Payout EntriesListPayoutEntriesGETRetrieves a list of all payout entries for a specific payout.
List PayoutsListPayoutsGETRetrieves a list of all payouts for the default location.
Refund3
Get Payment RefundGetPaymentRefundGETRetrieves a specific refund using the refund id.
List Payment RefundsListPaymentRefundsGETRetrieves a list of refunds for the account making the request.
Refund PaymentRefundPaymentPOSTRefunds a payment.
Site1
List SitesListSitesGETLists the Square Online sites that belong to a seller.
Snippet3
Delete SnippetDeleteSnippetDELETERemoves your snippet from a Square Online site.
Retrieve SnippetRetrieveSnippetGETRetrieves your snippet from a Square Online site.
Upsert SnippetUpsertSnippetPOSTAdds a snippet to a Square Online site or updates the existing snippet on the site.
Subscription12
Bulk Swap PlanBulkSwapPlanPOSTSchedules a plan variation change for all active subscriptions under a given plan variation.
Cancel SubscriptionCancelSubscriptionPOSTSchedules a CANCEL action to cancel an active subscription.
Change Billing Anchor DateChangeBillingAnchorDatePOSTChanges the billing anchor date for a subscription.
Create SubscriptionCreateSubscriptionPOSTEnrolls a customer in a subscription.
Delete Subscription ActionDeleteSubscriptionActionDELETEDeletes a scheduled action for a subscription.
List Subscription EventsListSubscriptionEventsGETLists all events for a specific subscription.
Pause SubscriptionPauseSubscriptionPOSTSchedules a PAUSE action to pause an active subscription.
Resume SubscriptionResumeSubscriptionPOSTSchedules a RESUME action to resume a paused or a deactivated subscription.
Retrieve SubscriptionRetrieveSubscriptionGETRetrieves a specific subscription.
Search SubscriptionsSearchSubscriptionsPOSTSearches for subscriptions.
Swap PlanSwapPlanPOSTSchedules a SWAP PLAN action to swap a subscription plan variation in an existing subscription.
Update SubscriptionUpdateSubscriptionPUTUpdates a subscription by modifying or clearing subscription field values.
Team12
Bulk Create Team MembersBulkCreateTeamMembersPOSTCreates multiple TeamMember objects.
Bulk Update Team MembersBulkUpdateTeamMembersPOSTUpdates multiple TeamMember objects.
Create JobCreateJobPOSTCreates a job in a seller account.
Create Team MemberCreateTeamMemberPOSTCreates a single TeamMember object.
List JobsListJobsGETLists jobs in a seller account.
Retrieve JobRetrieveJobGETRetrieves a specified job.
Retrieve Team MemberRetrieveTeamMemberGETRetrieves a TeamMember object for the given TeamMember.id.
Retrieve Wage SettingRetrieveWageSettingGETRetrieves a WageSetting object for a team member specified by TeamMember.id.
Search Team MembersSearchTeamMembersPOSTReturns a paginated list of TeamMember objects for a business.
Update JobUpdateJobPUTUpdates the title or tip eligibility of a job.
Update Team MemberUpdateTeamMemberPUTUpdates a single TeamMember object.
Update Wage SettingUpdateWageSettingPUTCreates or updates a WageSetting object.
Terminal15
Cancel Terminal ActionCancelTerminalActionPOSTCancels a Terminal action request if the status of the request permits it.
Cancel Terminal CheckoutCancelTerminalCheckoutPOSTCancels a Terminal checkout request if the status of the request permits it.
Cancel Terminal RefundCancelTerminalRefundPOSTCancels an Interac Terminal refund request by refund request ID if the status of the request permits it.
Create Terminal ActionCreateTerminalActionPOSTCreates a Terminal action request and sends it to the specified device.
Create Terminal CheckoutCreateTerminalCheckoutPOSTCreates a Terminal checkout request and sends it to the specified device to take a payment for the requested amount.
Create Terminal RefundCreateTerminalRefundPOSTCreates a request to refund an Interac payment completed on a Square Terminal.
Dismiss Terminal ActionDismissTerminalActionPOSTDismisses a Terminal action request if the status and type of the request permits it.
Dismiss Terminal CheckoutDismissTerminalCheckoutPOSTDismisses a Terminal checkout request if the status and type of the request permits it.
Dismiss Terminal RefundDismissTerminalRefundPOSTDismisses a Terminal refund request if the status and type of the request permits it.
Get Terminal ActionGetTerminalActionGETRetrieves a Terminal action request by action id.
Get Terminal CheckoutGetTerminalCheckoutGETRetrieves a Terminal checkout request by checkout id.
Get Terminal RefundGetTerminalRefundGETRetrieves an Interac Terminal refund object by ID.
Search Terminal ActionsSearchTerminalActionsPOSTRetrieves a filtered list of Terminal action requests created by the account making the request.
Search Terminal CheckoutsSearchTerminalCheckoutsPOSTReturns a filtered list of Terminal checkout requests created by the application making the request.
Search Terminal RefundsSearchTerminalRefundsPOSTRetrieves a filtered list of Interac Terminal refund requests created by the seller making the request.
Transaction4
Capture TransactionCaptureTransactionPOSTCaptures a transaction that was created with the Charge endpoint with a delay capture value of true.
List TransactionsListTransactionsGETLists transactions for a particular location.
Retrieve TransactionRetrieveTransactionGETRetrieves details for a single transaction.
Void TransactionVoidTransactionPOSTCancels a transaction that was created with the Charge endpoint with a delay capture value of true.
TransferOrder8
Cancel Transfer OrderCancelTransferOrderPOSTCancels a transfer order in STARTED or PARTIALLY RECEIVED status.
Create Transfer OrderCreateTransferOrderPOSTCreates a new transfer order in DRAFT status.
Delete Transfer OrderDeleteTransferOrderDELETEDeletes a transfer order in DRAFT status.
Receive Transfer OrderReceiveTransferOrderPOSTRecords receipt of CatalogItemVariations for a transfer order.
Retrieve Transfer OrderRetrieveTransferOrderGETRetrieves a specific TransferOrder by ID.
Search Transfer OrdersSearchTransferOrdersPOSTSearches for transfer orders using filters.
Start Transfer OrderStartTransferOrderPOSTChanges a DRAFT transfer order to STARTED status.
Update Transfer OrderUpdateTransferOrderPUTUpdates an existing transfer order.
V1Transaction3
V 1 List OrdersV1ListOrdersGETProvides summary information for a merchant's online store orders.
V 1 Retrieve OrderV1RetrieveOrderGETProvides comprehensive information for a single online store order, including the order's history.
V 1 Update OrderV1UpdateOrderPUTUpdates the details of an online store order.
Vendor7
Bulk Create VendorsBulkCreateVendorsPOSTCreates one or more Vendor objects to represent suppliers to a seller.
Bulk Retrieve VendorsBulkRetrieveVendorsPOSTRetrieves one or more vendors of specified Vendor IDs.
Bulk Update VendorsBulkUpdateVendorsPUTUpdates one or more of existing Vendor objects as suppliers to a seller.
Create VendorCreateVendorPOSTCreates a single Vendor object to represent a supplier to a seller.
Retrieve VendorRetrieveVendorGETRetrieves the vendor of a specified Vendor ID.
Search VendorsSearchVendorsPOSTSearches for vendors using a filter against supported Vendor properties and a supported sorter.
Update VendorUpdateVendorPUTUpdates an existing Vendor object as a supplier to a seller.
WebhookSubscription8
Create Webhook SubscriptionCreateWebhookSubscriptionPOSTCreates a webhook subscription.
Delete Webhook SubscriptionDeleteWebhookSubscriptionDELETEDeletes a webhook subscription.
List Webhook Event TypesListWebhookEventTypesGETLists all webhook event types that can be subscribed to.
List Webhook SubscriptionsListWebhookSubscriptionsGETLists all webhook subscriptions owned by your application.
Retrieve Webhook SubscriptionRetrieveWebhookSubscriptionGETRetrieves a webhook subscription identified by its ID.
Test Webhook SubscriptionTestWebhookSubscriptionPOSTTests a webhook subscription by sending a test event to the notification URL.
Update Webhook SubscriptionUpdateWebhookSubscriptionPUTUpdates a webhook subscription.
Update Webhook Subscription Signature KeyUpdateWebhookSubscriptionSignatureKeyPOSTUpdates a webhook subscription by replacing the existing signature key with a new one.