Integration · Payments
Connect Claude & ChatGPT to Square
Ask your AI what came in yesterday, what a payout contained or how much stock is left of an item, and it reads the answer from Square. It can create customers, orders, invoices and payment links, add or change catalog items, and refund payments, with your approval if you want it.
Connect Square free
Free plan, no credit card. Takes about a minute.
Try asking
“What card payments did the Nørrebro shop take yesterday?”
The AI finds the location and lists payments in that time window with amount, card brand and status.
“How many black canvas totes do we have left?”
It searches the catalog for the item and reads the current stock count for each location.
“Make a payment link for a 450 DKK gift card.”
It creates a quick-pay checkout link for that amount and gives you the URL to share.
What your AI can do
Payments, refunds and payouts
List and read payments, refunds and payouts by date or location, and refund a payment in full or in part.
Orders, invoices and links
Create and search orders, create, update, publish and cancel invoices, and make checkout payment links.
Customers and catalog
Search, create and update customers, read subscriptions, add or change catalog items and prices, and check stock counts.
“Invoice Maria Holm for the catering order, due in 14 days.”
It creates an order with the line items and a draft invoice for the customer. Publishing it sends the invoice or charges a card on file, depending on the settings.
“What was in Tuesday's payout?”
It lists your payouts, finds Tuesday's and shows its amount, status and destination.
“Refund Jonas's payment from this morning.”
It finds the payment and refunds it. The money goes back to the buyer.
301 tools for Square
These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.
approve_disputeVisible to othersAccept a dispute (dispute id). Has effects visible outside this system. API summary: AcceptDispute.archive_accountVisible to othersDisable a account (bank account id). Has effects visible outside this system. API summary: DisableBankAccount.archive_cardVisible to othersDisable a card (card id). Has effects visible outside this system. API summary: DisableCard.archive_eventDeletesDisable a event. Destructive action; may require approval. API summary: DisableEvents.attach_customer_customerChanges dataLink a customer (gift card id). API summary: LinkCustomerToGiftCard.cancel_actionDeletesCancel a action (action id). Destructive action; may require approval. API summary: CancelTerminalAction.cancel_bookingDeletesCancel a booking (booking id). Destructive action; may require approval. API summary: CancelBooking.cancel_checkoutDeletesCancel a checkout (checkout id). Destructive action; may require approval. API summary: CancelTerminalCheckout.cancel_invoiceDeletesCancel a published, unpaid invoice by `invoice_id` and `version`. The customer can no longer pay it. Cannot be undone.cancel_orderMoves moneyCancel a order (transfer order id). Financial or irreversible action; may require approval. API summary: CancelTransferOrder.cancel_paymentDeletesCancel a payment. Destructive action; may require approval. API summary: CancelPaymentByIdempotencyKey.cancel_payment_cancelDeletesCancel a payment (payment id). Destructive action; may require approval. API summary: CancelPayment.cancel_promotionDeletesCancel a promotion (promotion id). Destructive action; may require approval. API summary: CancelLoyaltyPromotion.cancel_refundMoves moneyCancel a refund (terminal refund id). Financial or irreversible action; may require approval. API summary: CancelTerminalRefund.cancel_subscriptionDeletesCancel a subscription (subscription id). Destructive action; may require approval. API summary: CancelSubscription.create_accountChanges dataCreate a new account. Required: idempotency key or source id. Search accounts first to avoid duplicates. API summary: CreateBankAccount.create_account_accumulateChanges dataCreate a new accumulate for a account. Required: accumulate points, idempotency key or location id. API summary: AccumulateLoyaltyPoints.create_account_adjustChanges dataCreate a new adjust for a account. Required: idempotency key or adjust points. API summary: AdjustLoyaltyPoints.create_account_create_loyalty_accountChanges dataCreate a new account. Required: loyalty account or idempotency key. Search accounts first to avoid duplicates. API summary: CreateLoyaltyAccount.create_actionChanges dataCreate a new action. Required: idempotency key or action. Search actions first to avoid duplicates. API summary: CreateTerminalAction.create_action_dismissChanges dataCreate a new dismiss for a action. API summary: DismissTerminalAction.create_addressChanges dataCreate a new address. API summary: CreateLocation.create_batch_deleteVisible to othersCreate a new batch delete. Required: object ids. Has effects visible outside this system. API summary: BatchDeleteCatalogObjects.create_batch_upsertVisible to othersCreate a new batch upsert. Required: idempotency key or batches. Has effects visible outside this system. API summary: BatchUpsertCatalogObjects.create_bookingChanges dataCreate a new booking. Required: booking. API summary: CreateBooking.create_break_typeChanges dataCreate a new break type. Required: break type. API summary: CreateBreakType.create_bulk_publishDeletesCreate a new bulk publish. Required: scheduled shifts. Destructive action; may require approval. API summary: BulkPublishScheduledShifts.create_bulk_swap_planVisible to othersCreate a new bulk swap plan. Required: new plan variation id, old plan variation id or location id. Has effects visible outside this system. API summary: BulkSwapPlan.create_cardChanges dataCreate a new card. Required: idempotency key, source id or card. API summary: CreateCard.create_checkoutChanges dataCreate a new checkout. Required: idempotency key or checkout. Search checkouts first to avoid duplicates. API summary: CreateTerminalCheckout.create_checkout_dismissChanges dataCreate a new dismiss for a checkout. API summary: DismissTerminalCheckout.create_codeChanges dataCreate a new code. Required: idempotency key or device code. API summary: CreateDeviceCode.create_customerChanges dataCreate a customer profile with `given_name`, `family_name`, `company_name`, `email_address`, `phone_number`, `address` or `note`. Search first to avoid duplicates.create_customer_2Visible to othersCreate a new customer. Required: booking ids. Search customers first to avoid duplicates. Has effects visible outside this system. API summary: BulkRetrieveBookings.create_customer_bulk_create_customersVisible to othersCreate a new customer. Required: customers. Search customers first to avoid duplicates. Has effects visible outside this system. API summary: BulkCreateCustomers.create_customer_bulk_create_team_membersVisible to othersCreate a new customer. Required: team members. Search customers first to avoid duplicates. Has effects visible outside this system. API summary: BulkCreateTeamMembers.create_customer_bulk_create_vendorsVisible to othersCreate a new customer. Required: vendors. Search customers first to avoid duplicates. Has effects visible outside this system. API summary: BulkCreateVendors.create_customer_bulk_retrieve_channelsVisible to othersCreate a new customer. Required: channel ids. Search customers first to avoid duplicates. Has effects visible outside this system. API summary: BulkRetrieveChannels.create_customer_bulk_retrieve_customersVisible to othersCreate a new customer. Required: customer ids. Search customers first to avoid duplicates. Has effects visible outside this system. API summary: BulkRetrieveCustomers.create_customer_bulk_retrieve_team_member_booking_profilesVisible to othersCreate a new customer. Required: team member ids. Search customers first to avoid duplicates. Has effects visible outside this system. API summary: BulkRetrieveTeamMemberBookingProfiles.create_customer_bulk_retrieve_vendorsVisible to othersCreate a new customer. Search customers first to avoid duplicates. Has effects visible outside this system. API summary: BulkRetrieveVendors.create_customer_bulk_update_customersVisible to othersCreate a new customer. Required: customers. Search customers first to avoid duplicates. Has effects visible outside this system. API summary: BulkUpdateCustomers.create_customer_bulk_update_team_membersVisible to othersCreate a new customer. Required: team members. Search customers first to avoid duplicates. Has effects visible outside this system. API summary: BulkUpdateTeamMembers.create_customer_create_customer_groupChanges dataCreate a new customer. Required: group. Search customers first to avoid duplicates. API summary: CreateCustomerGroup.create_customer_create_gift_cardChanges dataCreate a new customer. Required: idempotency key, location id or gift card. Search customers first to avoid duplicates. API summary: CreateGiftCard.create_dispute_documentChanges dataCreate a new document for a dispute. API summary: CreateDisputeEvidenceFile.create_dispute_evidence_textChanges dataCreate a new evidence text for a dispute. Required: idempotency key or evidence text. API summary: CreateDisputeEvidenceText.create_domainMoves moneyCreate a new domain. Required: domain name. Financial or irreversible action; may require approval. API summary: RegisterDomain.create_eventChanges dataCreate a new event. Search events first to avoid duplicates. API summary: SearchEvents.create_from_ganChanges dataCreate a new from gan. Required: gan. API summary: RetrieveGiftCardFromGAN.create_from_nonceChanges dataCreate a new from nonce. Required: nonce. API summary: RetrieveGiftCardFromNonce.create_imageChanges dataCreate a new image. API summary: CreateCatalogImage.create_inventoryChanges dataCreate a new inventory. Required: idempotency key or adjustment reason. API summary: CreateInventoryAdjustmentReason.create_inventory_batch_change_inventoryVisible to othersCreate a new inventory. Required: idempotency key. Has effects visible outside this system. API summary: BatchChangeInventory.create_inventory_create_vendorChanges dataCreate a new inventory. Required: idempotency key. API summary: CreateVendor.create_inventory_retrieve_inventory_adjustment_reasonChanges dataCreate a new inventory. Required: reason id. API summary: RetrieveInventoryAdjustmentReason.create_invoiceChanges dataCreate a draft invoice for an existing order: `invoice` with location_id, order_id, primary_recipient {customer_id}, payment_requests (request_type BALANCE, due_date) and delivery_method (EMAIL). Publish it with publish_invoice.create_invoice_documentChanges dataCreate a new document for a invoice. API summary: CreateInvoiceAttachment.create_orderChanges dataCreate an order: `order` with location_id, line_items (name or catalog_object_id, quantity, base_price_money) and optional customer_id. Needed before creating an invoice.create_order_2Changes dataCreate a new order. Required: custom attribute definition. Search orders first to avoid duplicates. API summary: CreateBookingCustomAttributeDefinition.create_order_batch_retrieve_catalog_objectsVisible to othersCreate a new order. Required: object ids. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BatchRetrieveCatalogObjects.create_order_batch_retrieve_inventory_changesVisible to othersCreate a new order. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BatchRetrieveInventoryChanges.create_order_batch_retrieve_inventory_countsVisible to othersCreate a new order. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BatchRetrieveInventoryCounts.create_order_batch_retrieve_ordersVisible to othersCreate a new order. Required: order ids. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BatchRetrieveOrders.create_order_bulk_delete_booking_custom_attributesVisible to othersCreate a new order. Required: values. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BulkDeleteBookingCustomAttributes.create_order_bulk_delete_customersVisible to othersCreate a new order. Required: customer ids. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BulkDeleteCustomers.create_order_bulk_delete_location_custom_attributesVisible to othersCreate a new order. Required: values. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BulkDeleteLocationCustomAttributes.create_order_bulk_delete_merchant_custom_attributesVisible to othersCreate a new order. Required: values. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BulkDeleteMerchantCustomAttributes.create_order_bulk_delete_order_custom_attributesVisible to othersCreate a new order. Required: values. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BulkDeleteOrderCustomAttributes.create_order_bulk_upsert_booking_custom_attributesVisible to othersCreate a new order. Required: values. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BulkUpsertBookingCustomAttributes.create_order_bulk_upsert_customer_custom_attributesVisible to othersCreate a new order. Required: values. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BulkUpsertCustomerCustomAttributes.create_order_bulk_upsert_location_custom_attributesVisible to othersCreate a new order. Required: values. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BulkUpsertLocationCustomAttributes.create_order_bulk_upsert_merchant_custom_attributesVisible to othersCreate a new order. Required: values. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BulkUpsertMerchantCustomAttributes.create_order_bulk_upsert_order_custom_attributesVisible to othersCreate a new order. Required: values. Search orders first to avoid duplicates. Has effects visible outside this system. API summary: BulkUpsertOrderCustomAttributes.create_order_create_customer_custom_attribute_definitionChanges dataCreate a new order. Required: custom attribute definition. Search orders first to avoid duplicates. API summary: CreateCustomerCustomAttributeDefinition.create_order_create_location_custom_attribute_definitionChanges dataCreate a new order. Required: custom attribute definition. Search orders first to avoid duplicates. API summary: CreateLocationCustomAttributeDefinition.create_order_create_merchant_custom_attribute_definitionChanges dataCreate a new order. Required: custom attribute definition. Search orders first to avoid duplicates. API summary: CreateMerchantCustomAttributeDefinition.create_order_create_order_custom_attribute_definitionChanges dataCreate a new order. Required: custom attribute definition. Search orders first to avoid duplicates. API summary: CreateOrderCustomAttributeDefinition.create_order_receive_transfer_orderMoves moneyCreate a new order for a order. Required: idempotency key or receipt. Search orders first to avoid duplicates. Financial or irreversible action; may require approval. API summary: ReceiveTransferOrder.create_order_start_transfer_orderMoves moneyCreate a new order for a order. Required: idempotency key. Search orders first to avoid duplicates. Financial or irreversible action; may require approval. API summary: StartTransferOrder.create_payment_create_paymentChanges dataCreate a new payment. Required: source id or idempotency key. API summary: CreatePayment.create_payment_linkChanges dataCreate a checkout payment link. For a simple amount use `quick_pay` {name, price_money {amount, currency}, location_id}; or pass an `order`. Returns a URL to share.create_program_promotionChanges dataCreate a new promotion for a program. Required: loyalty promotion or idempotency key. API summary: CreateLoyaltyPromotion.create_projectChanges dataCreate a new project. Required: job or idempotency key. API summary: CreateJob.create_refundMoves moneyCreate a new refund. Required: idempotency key. Search refunds first to avoid duplicates. Financial or irreversible action; may require approval. API summary: CreateTerminalRefund.create_refund_dismiss_terminal_refundMoves moneyCreate a new refund for a refund. Search refunds first to avoid duplicates. Financial or irreversible action; may require approval. API summary: DismissTerminalRefund.create_revokeDeletesCreate a new revoke. Destructive action; may require approval. API summary: RevokeToken.create_rewardChanges dataCreate a new reward. Required: reward or idempotency key. Search rewards first to avoid duplicates. API summary: CreateLoyaltyReward.create_reward_redeemChanges dataCreate a new redeem for a reward. Required: idempotency key or location id. API summary: RedeemLoyaltyReward.create_scheduled_shiftChanges dataCreate a new scheduled shift. Required: scheduled shift. Search scheduled shifts first to avoid duplicates. API summary: CreateScheduledShift.create_site_snippetChanges dataCreate a new snippet for a site. Required: snippet. API summary: UpsertSnippet.create_subscriptionChanges dataCreate a new subscription. Required: location id or customer id. Search subscriptions first to avoid duplicates. API summary: CreateSubscription.create_subscription_billing_anchorChanges dataCreate a new billing anchor for a subscription. API summary: ChangeBillingAnchorDate.create_subscription_create_webhook_subscriptionDeletesCreate a new subscription. Required: subscription. Search subscriptions first to avoid duplicates. Destructive action; may require approval. API summary: CreateWebhookSubscription.create_subscription_pause_subscriptionChanges dataCreate a new subscription for a subscription. Search subscriptions first to avoid duplicates. API summary: PauseSubscription.create_subscription_resume_subscriptionChanges dataCreate a new subscription for a subscription. Search subscriptions first to avoid duplicates. API summary: ResumeSubscription.create_subscription_swap_planChanges dataCreate a new swap plan for a subscription. API summary: SwapPlan.create_subscription_test_webhook_subscriptionDeletesCreate a new subscription for a subscription. Search subscriptions first to avoid duplicates. Destructive action; may require approval. API summary: TestWebhookSubscription.create_subscription_update_webhook_subscription_signature_keyDeletesCreate a new subscription for a subscription. Search subscriptions first to avoid duplicates. Destructive action; may require approval. API summary: UpdateWebhookSubscriptionSignatureKey.create_taskChanges dataCreate a new task. Required: idempotency key or gift card activity. API summary: CreateGiftCardActivity.create_timecardChanges dataCreate a new timecard. Required: timecard. Search timecards first to avoid duplicates. API summary: CreateTimecard.create_userChanges dataCreate a new user. Search users first to avoid duplicates. API summary: CreateTeamMember.delete_addressDeletesPermanently delete a address by address key. Destructive action; may require approval. API summary: DeleteLocationCustomAttribute.delete_booking_custom_attributeDeletesPermanently delete a custom attribute by custom attribute key. Destructive action; may require approval. API summary: DeleteBookingCustomAttribute.delete_break_typeDeletesPermanently delete a break type by break type id. Destructive action; may require approval. API summary: DeleteBreakType.delete_customerDeletesPermanently delete a customer by customer id. Destructive action; may require approval. API summary: DeleteCustomerGroup.delete_customer_delete_customerDeletesPermanently delete a customer by customer id. Destructive action; may require approval. API summary: DeleteCustomer.delete_customer_delete_customer_custom_attributeDeletesPermanently delete a customer by customer key. Destructive action; may require approval. API summary: DeleteCustomerCustomAttribute.delete_customer_remove_group_from_customerDeletesPermanently delete a customer by customer id 2. Destructive action; may require approval. API summary: RemoveGroupFromCustomer.delete_dispute_evidenceDeletesPermanently delete a evidence by evidence id. Destructive action; may require approval. API summary: DeleteDisputeEvidence.delete_inventoriesDeletesPermanently delete a inventory. Destructive action; may require approval. API summary: DeleteInventoryAdjustmentReason.delete_invoiceDeletesPermanently delete a invoice by invoice id. Destructive action; may require approval. API summary: DeleteInvoice.delete_invoice_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: DeleteInvoiceAttachment.delete_merchant_custom_attributeDeletesPermanently delete a custom attribute by custom attribute key. Destructive action; may require approval. API summary: DeleteMerchantCustomAttribute.delete_objectDeletesPermanently delete a object by object id. Destructive action; may require approval. API summary: DeleteCatalogObject.delete_orderDeletesPermanently delete a order by order key. Destructive action; may require approval. API summary: DeleteBookingCustomAttributeDefinition.delete_order_delete_customer_custom_attribute_definitionDeletesPermanently delete a order by order key. Destructive action; may require approval. API summary: DeleteCustomerCustomAttributeDefinition.delete_order_delete_location_custom_attribute_definitionDeletesPermanently delete a order by order key. Destructive action; may require approval. API summary: DeleteLocationCustomAttributeDefinition.delete_order_delete_merchant_custom_attribute_definitionDeletesPermanently delete a order by order key. Destructive action; may require approval. API summary: DeleteMerchantCustomAttributeDefinition.delete_order_delete_order_custom_attributeDeletesPermanently delete a order by order key. Destructive action; may require approval. API summary: DeleteOrderCustomAttribute.delete_order_delete_order_custom_attribute_definitionDeletesPermanently delete a order by order key. Destructive action; may require approval. API summary: DeleteOrderCustomAttributeDefinition.delete_order_delete_transfer_orderMoves moneyPermanently delete a order by order id. Financial or irreversible action; may require approval. API summary: DeleteTransferOrder.delete_paymentDeletesPermanently delete a payment by payment id. Destructive action; may require approval. API summary: DeletePaymentLink.delete_rewardDeletesPermanently delete a reward by reward id. Destructive action; may require approval. API summary: DeleteLoyaltyReward.delete_site_snippetsMoves moneyPermanently delete a snippet by site id. Financial or irreversible action; may require approval. API summary: DeleteSnippet.delete_subscriptionDeletesPermanently delete a subscription by subscription id 2. Destructive action; may require approval. API summary: DeleteSubscriptionAction.delete_subscription_delete_webhook_subscriptionDeletesPermanently delete a subscription by subscription id. Destructive action; may require approval. API summary: DeleteWebhookSubscription.delete_timecardDeletesPermanently delete a timecard by timecard id. Destructive action; may require approval. API summary: DeleteTimecard.detach_customer_customerChanges dataUnlink a customer (gift card id). API summary: UnlinkCustomerFromGiftCard.get_accountGet one account by v1 bank account id. API summary: GetBankAccountByV1Id.get_account_get_bank_accountGet one account by account id. API summary: GetBankAccount.get_account_retrieve_loyalty_accountGet one account by account id. API summary: RetrieveLoyaltyAccount.get_actionGet one action by action id. API summary: GetTerminalAction.get_addressGet one address by address id. API summary: RetrieveLocation.get_address_retrieve_location_custom_attributeGet one address for a address by address key. API summary: RetrieveLocationCustomAttribute.get_bookingGet one booking by booking id. API summary: RetrieveBooking.get_booking_custom_attributeGet one custom attribute for a booking by custom attribute key. API summary: RetrieveBookingCustomAttribute.get_break_typeGet one break type by break type id. API summary: GetBreakType.get_cardGet one card by card id. API summary: RetrieveCard.get_catalog_itemGet one catalog object (item, variation, category, tax) by `object_id`, with `include_related_objects` for variations and categories.get_channelGet one channel by channel id. API summary: RetrieveChannel.get_checkoutGet one checkout by checkout id. API summary: GetTerminalCheckout.get_codeGet one code by code id. API summary: GetDeviceCode.get_customerGet one customer profile by `customer_id`, with contact details, note and groups.get_customer_2Get one customer by customer id. API summary: RetrieveCustomerGroup.get_customer_retrieve_customer_custom_attributeGet one customer for a customer by customer key. API summary: RetrieveCustomerCustomAttribute.get_customer_retrieve_customer_segmentGet one customer by customer id. API summary: RetrieveCustomerSegment.get_customer_retrieve_gift_cardGet one customer by customer id. API summary: RetrieveGiftCard.get_deviceGet one device by device id. API summary: GetDevice.get_disputeGet one dispute by dispute id. API summary: RetrieveDispute.get_dispute_evidenceGet one evidence for a dispute by evidence id. API summary: RetrieveDisputeEvidence.get_inventoryGet one inventory by inventory id. API summary: RetrieveInventoryAdjustment.get_inventory_countGet current stock counts for an item variation by `catalog_object_id`, optionally for specific `location_ids`.get_inventory_retrieve_inventory_physical_countGet one inventory by inventory id. API summary: RetrieveInventoryPhysicalCount.get_invoiceGet one invoice by `invoice_id`, with status, payment requests, amounts and the public URL.get_location_booking_profileGet one location booking profile by location id. API summary: RetrieveLocationBookingProfile.get_location_settingGet one location setting by location id. API summary: RetrieveLocationSettings.get_merchantGet the connected Square business (merchant) details, such as name, country and currency.get_merchant_2Get one merchant by merchant id. API summary: RetrieveMerchant.get_merchant_custom_attributeGet one custom attribute for a merchant by custom attribute key. API summary: RetrieveMerchantCustomAttribute.get_orderGet one order by `order_id`, with line items, taxes, discounts, fulfillments and totals.get_order_2Get one order by order key. API summary: RetrieveBookingCustomAttributeDefinition.get_order_retrieve_customer_custom_attribute_definitionGet one order by order key. API summary: RetrieveCustomerCustomAttributeDefinition.get_order_retrieve_location_custom_attribute_definitionGet one order by order key. API summary: RetrieveLocationCustomAttributeDefinition.get_order_retrieve_merchant_custom_attribute_definitionGet one order by order key. API summary: RetrieveMerchantCustomAttributeDefinition.get_order_retrieve_order_custom_attributeGet one order for a order by order key. API summary: RetrieveOrderCustomAttribute.get_order_retrieve_order_custom_attribute_definitionGet one order by order key. API summary: RetrieveOrderCustomAttributeDefinition.get_order_retrieve_transfer_orderGet one order by order id. API summary: RetrieveTransferOrder.get_paymentGet one payment by `payment_id`, with amount, status, card details, order and refund info.get_payment_2Get one payment by payment id. API summary: RetrievePaymentLink.get_payoutGet one payout by `payout_id`, with amount, status and destination. Read-only.get_programGet one program by program id. API summary: RetrieveLoyaltyProgram.get_program_promotionGet one promotion for a program by promotion id. API summary: RetrieveLoyaltyPromotion.get_projectGet one project by project id. API summary: RetrieveJob.get_refundGet one refund by refund id. API summary: GetPaymentRefund.get_refund_get_terminal_refundGet one refund by terminal refund id. API summary: GetTerminalRefund.get_rewardGet one reward by reward id. API summary: RetrieveLoyaltyReward.get_scheduled_shiftGet one scheduled shift by scheduled shift id. API summary: RetrieveScheduledShift.get_shiftGet one shift by shift id. API summary: RetrieveCashDrawerShift.get_subscriptionGet one subscription by `subscription_id`, with plan, status, start date and charged-through date.get_subscription_retrieve_webhook_subscriptionGet one subscription by subscription id. API summary: RetrieveWebhookSubscription.get_supplierGet one supplier by supplier id. API summary: RetrieveVendor.get_team_member_booking_profileGet one team member booking profile by team member id. API summary: RetrieveTeamMemberBookingProfile.get_team_member_wageGet one team member wage by team member wage id. API summary: GetTeamMemberWage.get_timecardGet one timecard by timecard id. API summary: RetrieveTimecard.get_token_statusDeletesGet the current status of a token. Destructive action; may require approval. API summary: RetrieveTokenStatus.get_userGet one user by user id. API summary: RetrieveTeamMember.list_accountsList accounts. Optional filters: location id or customer id. Results are paginated. API summary: ListBankAccounts.list_addresses_list_location_custom_attributesList addresses for a address. Optional filters: visibility filter or with definitions. Results are paginated. API summary: ListLocationCustomAttributes.list_booking_custom_attributesList custom attributes for a booking. Optional filters: with definitions. Results are paginated. API summary: ListBookingCustomAttributes.list_bookingsList bookings. Optional filters: customer id, team member id, location id, start at min or start at max. Results are paginated. API summary: ListBookings.list_break_typesList break types. Optional filters: location id. Results are paginated. API summary: ListBreakTypes.list_business_booking_profilesList business booking profiles. API summary: RetrieveBusinessBookingProfile.list_cardsList cards. Optional filters: customer id, include disabled, reference id or sort order. Results are paginated. API summary: ListCards.list_channelsList channels. Optional filters: reference type, reference id or status. Results are paginated. API summary: ListChannels.list_codesList codes. Optional filters: location id, product type or status. Results are paginated. API summary: ListDeviceCodes.list_customersList customers. Optional filters: sort field, sort order or count. Results are paginated. API summary: ListCustomers.list_customers_list_customer_custom_attributesList customers for a customer. Optional filters: with definitions. Results are paginated. API summary: ListCustomerCustomAttributes.list_customers_list_customer_groupsList customers. Results are paginated. API summary: ListCustomerGroups.list_customers_list_customer_segmentsList customers. Results are paginated. API summary: ListCustomerSegments.list_customers_list_gift_cardsList customers. Optional filters: type, state or customer id. Results are paginated. API summary: ListGiftCards.list_devicesList devices. Optional filters: sort order or location id. Results are paginated. API summary: ListDevices.list_dispute_evidenceList evidence for a dispute. Results are paginated. API summary: ListDisputeEvidence.list_disputesList disputes. Optional filters: states or location id. Results are paginated. API summary: ListDisputes.list_event_typesList event types. Optional filters: api version. API summary: ListWebhookEventTypes.list_infosList infos. API summary: CatalogInfo.list_inventoriesList inventories. Optional filters: include deleted or include system codes. API summary: ListInventoryAdjustmentReasons.list_invoicesList invoices. Optional filters: location id. Results are paginated. API summary: ListInvoices.list_listsList lists. Optional filters: types or catalog version. Results are paginated. API summary: ListCatalog.list_location_booking_profilesList location booking profiles. Results are paginated. API summary: ListLocationBookingProfiles.list_locationsList your business locations with their IDs, addresses and currencies. Many calls take a `location_id`.list_merchant_custom_attributesList custom attributes for a merchant. Optional filters: visibility filter or with definitions. Results are paginated. API summary: ListMerchantCustomAttributes.list_merchant_settingsList merchant settings. API summary: RetrieveMerchantSettings.list_ordersList orders. Results are paginated. API summary: ListBookingCustomAttributeDefinitions.list_orders_list_customer_custom_attribute_definitionsList orders. Results are paginated. API summary: ListCustomerCustomAttributeDefinitions.list_orders_list_location_custom_attribute_definitionsList orders. Optional filters: visibility filter. Results are paginated. API summary: ListLocationCustomAttributeDefinitions.list_orders_list_merchant_custom_attribute_definitionsList orders. Optional filters: visibility filter. Results are paginated. API summary: ListMerchantCustomAttributeDefinitions.list_orders_list_order_custom_attribute_definitionsList orders. Optional filters: visibility filter. Results are paginated. API summary: ListOrderCustomAttributeDefinitions.list_orders_list_order_custom_attributesList orders for a order. Optional filters: visibility filter or with definitions. Results are paginated. API summary: ListOrderCustomAttributes.list_payment_linksList your checkout payment links with their URLs and order IDs.list_paymentsList card and other payments, filtered by `begin_time`/`end_time` (RFC 3339), `location_id`, `last_4` or `card_brand`, with `cursor` paging.list_payoutsList payouts from Square to your bank account, filtered by `begin_time`/`end_time`, `status` or `location_id`. Read-only.list_program_promotionsList promotions for a program. Optional filters: status. Results are paginated. API summary: ListLoyaltyPromotions.list_projectsList projects. Results are paginated. API summary: ListJobs.list_refundsList refunds, filtered by `begin_time`/`end_time`, `location_id` or `status`, with `cursor` paging.list_shift_eventsList events for a shift. Optional filters: location id. Results are paginated. API summary: ListCashDrawerShiftEvents.list_shiftsList shifts. Optional filters: location id, sort order, begin time or end time. Results are paginated. API summary: ListCashDrawerShifts.list_site_snippetsList snippets for a site. API summary: RetrieveSnippet.list_sitesList sites. API summary: ListSites.list_subscriptionsList subscriptions for a subscription. Results are paginated. API summary: ListSubscriptionEvents.list_subscriptions_list_webhook_subscriptionsList subscriptions. Optional filters: include disabled or sort order. Results are paginated. API summary: ListWebhookSubscriptions.list_tasksList tasks. Optional filters: gift card id, type, location id, begin time, end time or sort order. Results are paginated. API summary: ListGiftCardActivities.list_team_member_booking_profilesList team member booking profiles. Optional filters: bookable only or location id. Results are paginated. API summary: ListTeamMemberBookingProfiles.list_team_member_wagesList team member wages. Optional filters: team member id. Results are paginated. API summary: ListTeamMemberWages.list_typesList types. Optional filters: api version. API summary: ListEventTypes.list_user_wage_settingsList wage settings for a user. API summary: RetrieveWageSetting.list_workweek_configsList workweek configs. Results are paginated. API summary: ListWorkweekConfigs.pay_orderMoves moneyPay a order (order id). Financial or irreversible action; may require approval. API summary: PayOrder.pay_order_transferMoves moneyTransfer a order. Financial or irreversible action; may require approval. API summary: CreateTransferOrder.pay_payout_entriesMoves moneyPayout a payout (payout id). Financial or irreversible action; may require approval. Results are paginated. API summary: ListPayoutEntries.publish_invoiceVisible to othersPublish (send) a draft invoice by `invoice_id` and `version`; Square emails it to the customer or charges a card on file, depending on the invoice settings.refund_paymentMoves moneyRefund a payment: `payment_id`, `amount_money` {amount in smallest unit, e.g. 1000 = 10.00, currency}, optional `reason`, and a unique `idempotency_key` (any new string). Sends money back to the buyer.restore_eventVisible to othersEnable a event. Has effects visible outside this system. API summary: EnableEvents.restore_inventoryChanges dataRestore a inventory. API summary: RestoreInventoryAdjustmentReason.search_accountsChanges dataSearch accounts. Use this to find existing accounts before creating a new account. API summary: SearchLoyaltyAccounts.search_actionsChanges dataSearch actions. Use this to find existing actions before creating a new action. API summary: SearchTerminalActions.search_availabilitiesChanges dataSearch availabilities. Use this to find existing availabilities before creating a new availability. API summary: SearchAvailability.search_catalog_itemsChanges dataSearch products (catalog items) by `text_filter`, `category_ids`, `stock_levels` (LOW, OUT) or `product_types`.search_catalogsChanges dataSearch catalogs. Use this to find existing catalogs before creating a new catalog. API summary: SearchCatalogObjects.search_checkoutsChanges dataSearch checkouts. Use this to find existing checkouts before creating a new checkout. API summary: SearchTerminalCheckouts.search_customersChanges dataSearch customers with a `query` filter (e.g. email_address {fuzzy}, phone_number, created_at) and sort; returns IDs for other calls.search_eventsChanges dataSearch events. Use this to find existing events before creating a new event. API summary: SearchLoyaltyEvents.search_invoicesChanges dataSearch invoices with `query` {filter: {location_ids: [...], customer_ids: [...]}}; location_ids is required.search_ordersChanges dataSearch orders across `location_ids` (required by Square) with a `query` filter on state, dates or customer, and `cursor` paging.search_orders_searchMoves moneySearch orders. Use this to find existing orders before creating a new order. Financial or irreversible action; may require approval. API summary: SearchTransferOrders.search_refundsChanges dataSearch refunds. Use this to find existing refunds before creating a new refund. API summary: SearchTerminalRefunds.search_rewardsChanges dataSearch rewards. Use this to find existing rewards before creating a new reward. API summary: SearchLoyaltyRewards.search_scheduled_shiftsChanges dataSearch scheduled shifts. Use this to find existing scheduled shifts before creating a new scheduled shift. API summary: SearchScheduledShifts.search_subscriptionsChanges dataSearch subscriptions with a `query` filter on customer_ids, location_ids or source names.search_suppliersChanges dataSearch suppliers. Use this to find existing suppliers before creating a new supplier. API summary: SearchVendors.search_timecardsChanges dataSearch timecards. Use this to find existing timecards before creating a new timecard. API summary: SearchTimecards.search_usersChanges dataSearch users. Use this to find existing users before creating a new user. API summary: SearchTeamMembers.submit_dispute_evidenceVisible to othersSubmit a dispute (dispute id). Has effects visible outside this system. API summary: SubmitEvidence.submit_orderVisible to othersCalculate a order. Has effects visible outside this system. API summary: CalculateOrder.submit_order_cloneVisible to othersClone a order. Has effects visible outside this system. API summary: CloneOrder.submit_paymentVisible to othersComplete a payment (payment id). Has effects visible outside this system. API summary: CompletePayment.submit_programVisible to othersCalculate a program (program id). Has effects visible outside this system. API summary: CalculateLoyaltyPoints.submit_scheduled_shiftVisible to othersPublish a scheduled shift (scheduled shift id). Has effects visible outside this system. API summary: PublishScheduledShift.update_addressChanges dataUpdate an existing address identified by address id. API summary: UpdateLocation.update_address_upsert_location_custom_attributeChanges dataUpdate an existing address identified by address key. API summary: UpsertLocationCustomAttribute.update_bookingChanges dataUpdate an existing booking identified by booking id. API summary: UpdateBooking.update_booking_custom_attributeChanges dataUpdate an existing custom attribute identified by custom attribute key. API summary: UpsertBookingCustomAttribute.update_break_typeChanges dataUpdate an existing break type identified by break type id. API summary: UpdateBreakType.update_catalogs_item_modifier_listsChanges dataUpdate an existing catalog. API summary: UpdateItemModifierLists.update_catalogs_item_taxesChanges dataUpdate an existing catalog. API summary: UpdateItemTaxes.update_customerChanges dataUpdate a customer by `customer_id`; only the fields you pass (name, email, phone, address, note) change.update_customer_2Changes dataUpdate an existing customer identified by customer id. API summary: UpdateCustomerGroup.update_customer_add_group_to_customerChanges dataUpdate an existing customer identified by customer id 2. API summary: AddGroupToCustomer.update_customer_upsert_customer_custom_attributeChanges dataUpdate an existing customer identified by customer key. API summary: UpsertCustomerCustomAttribute.update_customersVisible to othersUpdate an existing customer. Has effects visible outside this system. API summary: BulkUpdateVendors.update_imageChanges dataUpdate an existing image identified by image id. API summary: UpdateCatalogImage.update_inventoriesVisible to othersUpdate an existing inventory. Has effects visible outside this system. API summary: UpdateInventoryAdjustmentReason.update_invoiceChanges dataUpdate an invoice by `invoice_id`; pass `invoice` with its current version and the fields to change.update_location_settingChanges dataUpdate an existing location setting identified by location id. API summary: UpdateLocationSettings.update_merchant_custom_attributeChanges dataUpdate an existing custom attribute identified by custom attribute key. API summary: UpsertMerchantCustomAttribute.update_merchant_settingsVisible to othersUpdate an existing merchant setting. Has effects visible outside this system. API summary: UpdateMerchantSettings.update_orderChanges dataUpdate an existing order identified by order key. API summary: UpdateBookingCustomAttributeDefinition.update_order_update_orderChanges dataUpdate an existing order identified by order id. API summary: UpdateOrder.update_order_update_transfer_orderMoves moneyUpdate an existing order identified by order id. Financial or irreversible action; may require approval. API summary: UpdateTransferOrder.update_order_upsert_order_custom_attributeChanges dataUpdate an existing order identified by order key. API summary: UpsertOrderCustomAttribute.update_paymentChanges dataUpdate an existing payment identified by payment id. API summary: UpdatePaymentLink.update_payment_update_paymentChanges dataUpdate an existing payment identified by payment id. API summary: UpdatePayment.update_projectChanges dataUpdate an existing project identified by project id. API summary: UpdateJob.update_scheduled_shiftChanges dataUpdate an existing scheduled shift identified by scheduled shift id. API summary: UpdateScheduledShift.update_subscriptionChanges dataUpdate an existing subscription identified by subscription id. API summary: UpdateSubscription.update_supplierChanges dataUpdate an existing supplier identified by supplier id. API summary: UpdateVendor.update_timecardChanges dataUpdate an existing timecard identified by timecard id. API summary: UpdateTimecard.update_userChanges dataUpdate an existing user identified by user id. API summary: UpdateTeamMember.update_user_wage_settingsVisible to othersUpdate an existing wage setting identified by team member id. Has effects visible outside this system. API summary: UpdateWageSetting.update_workweek_configChanges dataUpdate an existing workweek config identified by workweek config id. API summary: UpdateWorkweekConfig.upsert_catalog_itemChanges dataCreate or update a catalog object such as an item with variations and prices: pass `object` (type ITEM, item_data) and a unique `idempotency_key`. For updates include the object's id and version.
Set up in three steps
- 1
Pick the app
Create a free HeyMyApps account and choose Square from the app list.
- 2
Paste your key
Paste a Square production access token. Sign in at developer.squareup.com/apps with your Square account, create an application or open an existing one, and switch to Production. On the Credentials page, copy the Production Access token.
- 3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
- Click your name, then Settings › Connectors › Add custom connector.
- Paste your link as the Remote MCP server URL.
- Switch it on from the + menu in a chat.
Questions
What can the AI do in Square?
It can read and search payments, refunds, payouts, orders, invoices, customers, subscriptions, catalog items, stock counts, payment links and your locations. It can create customers, orders, invoices and payment links, add or update catalog items, update customers and invoices, publish or cancel invoices and refund payments.
Does the AI see my Square access token?
No. Your Square access token is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.
Can I control what the AI is allowed to do?
Yes. Switch on only the tools you want, for example lookups without refunds. Actions that move money or reach customers, like refund_payment and publish_invoice, can require your approval before they run, and cancelling an invoice cannot be undone. Every tool call is logged.
Does it work with ChatGPT?
Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.
What does it cost?
HeyMyApps has a free plan, and you do not need a credit card to start. Paid plans bill per completed task. You also need your own Square account.
Why does the AI ask for a location?
Many Square calls work per business location, and Square requires location IDs when searching orders and invoices. The AI can list your locations with their IDs, addresses and currencies and pick the right one, so you can just name the shop.
Let your AI work in Square today.
Start free. Your key stays encrypted, and you decide what the AI may do.
Connect Square freeHeyMyApps is not affiliated with Square. Product names are trademarks of their owners.