Built by Metorial, the integration platform for agentic AI.
Retrieve full details of a specific customer profile by ID. Returns contact information, address, notes, preferences, and group memberships.
Retrieve details for a single Square business location. Use "main" as the location ID to retrieve the main location.
Retrieve full details of a specific invoice by its ID, including payment requests, recipients, and accepted payment methods.
Retrieve a specific catalog object by its ID. Returns full object data including related objects (e.g., item variations, modifier lists) when requested.
Retrieve Square payment refunds with pagination and filters for created time, updated time, location, status, and source type.
Update a Square invoice using sparse invoice fields and the current invoice version. Some fields, including order_id and location_id, cannot be changed by Square.
Retrieve full details of a specific payment by its ID. Returns comprehensive payment information including amount, status, card details, and receipt URL.
Complete or cancel an existing payment. Use "complete" to capture a previously authorized (delayed) payment, or "cancel" to void it.
Update an open Square order using sparse order fields and the current order version. Use fieldsToClear to clear supported dot-notation fields.
Retrieve full details for a Square payment refund by refund ID.
Issue a full or partial refund for a Square payment. Specify the payment ID and the amount to refund. Optionally provide a reason for the refund.
Mark a Square order as paid using approved delayed-capture payment IDs, or settle a zero-total order with an empty paymentIds array.
Publish, cancel, or delete an invoice. Publishing sends the invoice to the customer. Canceling stops a published invoice. Deleting permanently removes a draft invoice.
Retrieve inventory counts for one or more catalog item variations. Can look up counts for a single item variation or batch retrieve counts for multiple items across locations.
Delete a catalog object by its ID. Deleting an item also deletes its variations. Deleted objects can still be referenced by existing orders.
Search Square invoices for a location, optionally narrowed to one customer. Square currently supports one location and optionally one customer in the invoice search filter.
Create a new order at a Square location. Supports line items, taxes, discounts, fulfillments, and customer association. Orders start in OPEN state.
Retrieve a list of invoices for a specific location. Returns invoice summaries including status, amounts, and recipients.
Retrieve a list of customer profiles. Supports pagination and sorting by creation date or default order.
Search for orders across one or more locations. Supports filtering by date range, fulfillment state, customer, and other criteria. Use this to find and list orders.
Create a new customer profile. Provide at least one of: given name, family name, company name, email address, or phone number.
Search Square customer profiles using common filters or an advanced Square customer query object. Newly created or updated customers can take time to appear in search results.
Create a new payment using a payment source (nonce, card on file, etc.). Supports setting amount, tip, customer, location, and delayed capture.
Retrieve full details of a specific order by its ID. Returns line items, taxes, discounts, fulfillments, tenders, and all order metadata.
Search the Square catalog for items, variations, categories, taxes, discounts, and other catalog objects. Supports text search, category filtering, and object type filtering.
Update an existing customer profile. Only provided fields will be updated; omitted fields remain unchanged.
Create a new draft invoice for an existing order. The invoice must be published separately before it can be sent to the customer.
Retrieve all business locations associated with the Square account. Returns location names, addresses, statuses, and capabilities. Useful for obtaining location IDs needed by other tools.
Permanently delete a customer profile from the Square account. This action cannot be undone.
Retrieve the authenticated Square merchant profile, or a specific merchant profile by merchant ID.
Create or update a catalog object (item, variation, category, tax, discount, modifier list, etc.). Use a temporary ID starting with '#' for new objects. For updates, provide the existing object ID and current version.
Make inventory changes such as adjustments, physical counts, or transfers. Supports batch operations for multiple catalog items and locations simultaneously.
Retrieve a list of payments taken by the Square account. Supports filtering by time range, location, and pagination. Returns payment details including amounts, status, and source type.