Square
for LuumenAI
Square provides payment processing, POS systems, invoicing, and e-commerce tools, enabling sellers to accept card payments and manage their business
Operate Square from the same conversation as the hosts it runs on. Check jobs, queues, and interfaces without a second console; run diagnostic reports; and restart or update with the change previewed, approved, and logged.
The Square toolbox
122 tools: 59 read, 63 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadCalculate OrderPreview order pricing without creating an order.
- ReadGet BookingRetrieves detailed information about a specific Square booking by its ID.
- ReadGet Business Booking ProfileRetrieve the business booking profile for a Square merchant via GraphQL.
- ReadGet Current MerchantRetrieve merchant information associated with the access token using Square's GraphQL API.
- ReadGet Customer Custom AttributeRetrieves a custom attribute from a customer profile in Square.
- ReadGet Customer Custom Attribute DefinitionRetrieve a customer-related custom attribute definition from Square.
- ReadGet Customers via GraphQLRetrieve customer profiles from Square Customer Directory using GraphQL API.
- ReadGet Dispute EvidenceRetrieves detailed information about a specific piece of evidence that was uploaded for a dispute.
- ReadGet Gift Card From GANRetrieves detailed information about a gift card by its GAN (gift card account number).
- ReadGet InvoiceRetrieves detailed information about a specific Square invoice by its ID.
- ReadGet Loyalty AccountRetrieve detailed information about a specific Square loyalty account by ID.
- ReadGet MerchantRetrieve detailed information about a specific Square merchant by ID.
- ReadGet Online Checkout Location SettingsRetrieve location-level settings for Square online checkout.
- ReadGet Payment RefundRetrieves a specific payment refund by its unique ID from Square.
- ReadGet SubscriptionRetrieves detailed information about a specific Square customer subscription by its ID.
- ReadGet Team MemberRetrieve detailed information about a specific Square team member by ID.
- ReadList CardsRetrieve cards on file associated with a Square account.
- ReadList ChannelsList requested channels from Square.
- ReadList Customer Custom Attribute DefinitionsList customer-related custom attribute definitions from Square.
- ReadList Customer Custom Attribute Definitions (GraphQL)Retrieve customer custom attribute definitions via Square's GraphQL API.
- ReadList Customer Custom AttributesList custom attributes for a customer profile.
- ReadList Customer GroupsRetrieve the list of customer groups of a business.
- ReadList CustomersRetrieve customer profiles associated with a Square account.
- ReadList Customer SegmentsRetrieve the list of customer segments of a business.
- ReadList Dispute EvidenceList evidence items associated with a given dispute.
- ReadList InvoicesList invoices for a Square location.
- ReadList Location Custom Attribute DefinitionsList location-related custom attribute definitions from Square.
- ReadList LocationsRetrieve all business locations from a Square account.
- ReadList Locations Custom AttributesList custom attributes for a specific location in Square.
- ReadList Merchant Custom Attribute DefinitionsList merchant-related custom attribute definitions from Square.
- ReadList MerchantsRetrieve merchant account information associated with the access token.
- ReadList Merchants Custom AttributesList custom attributes for a specific merchant in Square.
- ReadList PaymentsList payments by location and time range to enable reconciliation and net sales reporting from Square POS.
- ReadList SubscriptionsSearch and list Square customer billing subscriptions.
- ReadList Webhook Event TypesList available webhook event types.
- ReadList Webhook SubscriptionsList all webhook subscriptions owned by your application.
- ReadRetrieve Bulk CustomersRetrieve multiple customer profiles in a single request.
- ReadRetrieve ChannelRetrieve a Square channel by its ID.
- ReadBulk Retrieve ChannelsBulk retrieve multiple Square channels by their IDs in a single request.
- ReadRetrieve CustomerRetrieve detailed information about a specific Square customer by ID.
- ReadRetrieve Customer GroupRetrieve a specific Square customer group by ID.
- ReadRetrieve Customer SegmentRetrieve a specific customer segment by its ID.
- ReadRetrieve DisputeRetrieve a Square dispute by ID.
- ReadRetrieve Inventory ChangesRetrieves the inventory change history for a catalog object at specified locations.
- ReadBatch Retrieve Inventory CountsRetrieve inventory counts for multiple catalog objects and locations in a single batch request.
- ReadRetrieve LocationRetrieve detailed information about a specific Square location by ID.
- ReadRetrieve Location Custom AttributeRetrieves a custom attribute associated with a location in Square.
- ReadRetrieve Location Custom Attribute DefinitionRetrieve a location-related custom attribute definition.
- ReadRetrieve Merchant Custom AttributeRetrieves a custom attribute associated with a merchant in Square.
- ReadRetrieve Merchant Custom Attribute DefinitionRetrieve a merchant-related custom attribute definition from Square.
- ReadRetrieve MerchantsRetrieve merchant information including status, main location details, and capabilities using Square's GraphQL API.
- ReadRetrieve OrderRetrieves detailed information about a specific Square order by its ID.
- ReadRetrieve Payment LinkRetrieves a Square-hosted payment link by ID.
- ReadRetrieve Token StatusRetrieve information about an OAuth access token or personal access token.
- ReadRetrieve Webhook SubscriptionRetrieve a Square webhook subscription by its ID.
- ReadSearch Booking AvailabilitySearches for available appointment time slots for booking services at Square locations.
- ReadSearch Catalog ObjectsSearches for catalog objects (items, categories, taxes, discounts, etc.) in the Square catalog.
- ReadSearch CustomersSearch customer profiles in Square Customer Directory.
- ReadSearch OrdersSearch orders across one or more Square locations with filters.
- WriteAccept DisputeAccept a dispute and acknowledge liability, returning funds to the cardholder. Approval by default
- WriteAdd Group to CustomerAdd a customer to a customer group. Approval by default
- WriteCancel BookingCancels an existing Square booking, terminating the reservation. Approval by default
- WriteCancel InvoiceCancels a Square invoice, preventing further payments from being collected. Approval by default
- WriteCancel PaymentCancels (voids) a payment that is in APPROVED status. Approval by default
- WriteBatch Create Inventory ChangesApplies multiple inventory adjustments and physical counts in a single batch request. Approval by default
- WriteCreate Bulk CustomersCreate multiple customer profiles in a single request. Approval by default
- WriteCreate CardCreate a card on file. Approval by default
- WriteCreate CustomerCreate a new customer profile in Square. Approval by default
- WriteCreate Customer Custom Attribute DefinitionCreate a customer-related custom attribute definition. Approval by default
- WriteCreate Customer GroupCreate a new customer group for a business. Approval by default
- WriteCreate Dispute Evidence FileUpload a file as dispute evidence. Approval by default
- WriteCreate Dispute Evidence TextUpload text evidence for a dispute challenge. Approval by default
- WriteCreate Gift Card ActivityCreates a gift card activity to manage gift card balances. Approval by default
- WriteCreate Invoice AttachmentUpload and attach a file to a Square invoice. Approval by default
- WriteCreate LocationCreate a new business location in a Square account. Approval by default
- WriteCreate Location Custom Attribute DefinitionCreate a location-related custom attribute definition. Approval by default
- WriteCreate OrderCreates a new Square order with line items, taxes, discounts, and fulfillment details. Approval by default
- WriteCreate RefundRefunds a Square payment in full or partially. Approval by default
- WriteCreate Team MemberCreate a new team member in Square. Approval by default
- WriteDelete Catalog ObjectDelete a Square catalog object by ID. Approval by default
- WriteDelete Catalog Objects (Batch)Deletes a set of CatalogObjects based on a list of target object IDs and returns a set of successfully deleted IDs in the response. Approval by default
- WriteDelete CustomerDelete a Square customer profile. Approval by default
- WriteDelete Customer Custom AttributeDelete a custom attribute from a customer profile. Approval by default
- WriteDelete Customer Custom Attribute DefinitionDelete a customer-related custom attribute definition. Approval by default
- WriteDelete Customer GroupDelete a customer group by its ID. Approval by default
- WriteBulk Delete CustomersBulk delete customer profiles from Square. Approval by default
- WriteDelete Dispute EvidenceRemoves a specific piece of evidence from a dispute. Approval by default
- WriteDelete InvoiceDelete a Square invoice (only DRAFT invoices can be deleted). Approval by default
- WriteDelete Invoice AttachmentDelete an attachment from a Square invoice. Approval by default
- WriteDelete Location Custom AttributeDelete a custom attribute from a location. Approval by default
- WriteDelete Location Custom Attribute DefinitionDelete a location-related custom attribute definition. Approval by default
- WriteDelete Locations Custom Attributes (Batch)Delete custom attributes from multiple locations in a single batch request. Approval by default
- WriteDelete Merchant Custom AttributeDelete a custom attribute from a merchant profile. Approval by default
- WriteDelete Merchant Custom Attribute DefinitionDelete a merchant-related custom attribute definition. Approval by default
- WriteDelete Merchants Custom Attributes (Batch)Delete custom attributes from multiple merchants in a single batch request. Approval by default
- WriteDelete Webhook SubscriptionPermanently deletes a webhook subscription by its ID. Approval by default
- WriteLink Customer to Gift CardLink a customer to a gift card in Square. Approval by default
- WritePay OrderPays an existing Square order by processing approved payments and completing the transaction. Approval by default
- WriteRemove Group From CustomerRemoves a customer from a customer group. Approval by default
- WriteSubmit Dispute EvidenceSubmits evidence for a dispute to the cardholder's bank. Approval by default
- WriteTest Webhook SubscriptionTests a webhook subscription by sending a test event to the configured notification URL. Approval by default
- WriteUpdate BookingUpdates an existing Square booking with new appointment details, times, notes, or team members. Approval by default
- WriteUpdate CustomerUpdate an existing Square customer profile. Approval by default
- WriteUpdate Customer Custom Attribute DefinitionUpdate a customer-related custom attribute definition in Square. Approval by default
- WriteUpdate Customer GroupUpdate a customer group's information by its ID. Approval by default
- WriteBulk Update CustomersUpdate multiple customer profiles in a single batch operation. Approval by default
- WriteUpdate LocationUpdate an existing business location in a Square account. Approval by default
- WriteUpdate Location Custom Attribute DefinitionUpdate a location-related custom attribute definition in Square. Approval by default
- WriteUpdate Merchant Custom Attribute DefinitionUpdate a merchant-related custom attribute definition in Square. Approval by default
- WriteUpdate Online Checkout Location SettingsUpdate location-level settings for Square online checkout. Approval by default
- WriteUpdate OrderUpdates an existing Square order by adding, modifying, or removing fields. Approval by default
- WriteUpdate Team MemberUpdate an existing Square team member's information. Approval by default
- WriteUpdate Webhook SubscriptionUpdate a Square webhook subscription. Approval by default
- WriteUpdate Webhook Subscription Signature KeyRotate the signature key for a webhook subscription. Approval by default
- WriteUpsert Catalog ObjectCreates or updates a catalog object in the Square catalog. Approval by default
- WriteBatch Upsert Catalog ObjectsCreates or updates multiple catalog objects in a single batch operation. Approval by default
- WriteUpsert Customer Custom AttributeCreate or update a custom attribute for a customer profile. Approval by default
- WriteBatch Upsert Customer Custom AttributesCreate or update custom attributes for multiple customers in a single batch request. Approval by default
- WriteUpsert Location Custom AttributeCreate or update a custom attribute for a location. Approval by default
- WriteBatch Upsert Locations Custom AttributesCreate or update custom attributes for multiple locations in a single batch request. Approval by default
- WriteUpsert Merchant Custom AttributeCreate or update a custom attribute for a merchant profile. Approval by default
- WriteBatch Upsert Merchants Custom AttributesCreate or update custom attributes for multiple merchants in a single batch request. Approval by default
Questions
How does LuumenAI connect to Square?
Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in Square on its own?
Read actions answer immediately. Anything that writes — accept dispute, add group to customer, cancel booking, cancel invoice, and more — is shown as a plan and requires approval by default, including the 24 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to Square — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
SAP BTPGateways, jobs, and subaccounts operated from one governed chat.
SalesforceRecords and integration jobs checked without a second console.
SAP S/4HANAJobs, queues, and records in SAP S/4HANA without a second console.
SAP SuccessFactorsJobs, queues, and records in SAP SuccessFactors without a second console.Put Square to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.