How do I connect Square to Operator?

You authorize Square once from your Operator dashboard. Operator holds the connection and refreshes the access token for you, so your agent keeps working with Square without you signing in again.

Can my agent manage my store in Square?

Yes. It can read and update products, orders, and customers, and report on what is happening. Ask for the day's orders or to adjust stock and it runs the matching Square actions, so you run the store from a chat instead of the admin panel.

Do I need to write code or manage Square API keys?

No code and no API keys. You authorize Square through a normal sign in and Operator handles the connection, so there is nothing to wire up or host.

Can my agent use Square together with my other apps?

Yes. The same agent reaches every app you connect, so it can move between Square and tools like Shopify, Cloudcart, Baselinker in one job, reading from one and acting in another without you wiring anything between them.

← All integrations

Connect Square to OpenClaw on Operator.io

Square is a platform for payment processing, POS, invoicing, and e-commerce. It empowers businesses to accept payments, manage sales, and streamline operations from one place.

E-Commerce96 actions

Try for free

Automate Square with AI

Hand Square to an OpenClaw agent running on Operator. You write what you want in a chat and it turns that into real Square actions like accept dispute, add group to customer, calculate order, without you opening the app.

Your agent reaches Square directly or through connectors like Composio MCP and Pipedream MCP, which handle the sign in and token refresh for you, so there is nothing to wire up and no API keys to paste.

What your agent can do with Square

Your agent can call any of these Square actions by name as part of a larger task. Ask for the outcome you want and it picks the right ones.

Accept Dispute

Accept a dispute and acknowledge liability, returning funds to the cardholder. When you accept a dispute, Square debits the disputed amount from your account and updates the dispute state to ACCEPTED. This action is irreversible - once a...

Add Group to Customer

Tool to add a customer to a customer group. Use when you need to associate a customer with a specific group for targeted marketing, loyalty programs, or customer segmentation.

Calculate Order

Tool to preview order pricing without creating an order. Use when you need to calculate the total cost, taxes, discounts, and other pricing details for an order before finalizing it. Particularly useful for integrating rewards, discounts...

Cancel Invoice

Cancels a Square invoice, preventing further payments from being collected. Requirements: - Invoice must be in SCHEDULED, UNPAID, or PARTIALLY_PAID state - Cannot cancel invoices in DRAFT state or terminal states (PAID, REFUNDED, CANCELE...

Cancel Payment

Cancels (voids) a payment that is in APPROVED status. This is typically used in delayed capture scenarios where a payment was authorized but not yet captured, allowing you to void the authorization before settlement. Important: Only paym...

Create Bulk Customers

Tool to create multiple customer profiles in a single request. Use when you need to efficiently create up to 100 customers at once. Each customer is identified by a unique idempotency key.

Create Card

Tool to create a card on file. Use when you need to securely store a customer's card for future payments. Requires a valid nonce or payment ID.

Create Customer

Tool to create a new customer profile in Square. Use when you need to add a customer to the Square account. At least one of given_name, family_name, company_name, email_address, or phone_number is required.

Create Customer Custom Attribute Definition

Tool to create a customer-related custom attribute definition. Use when you need to define a new custom attribute that can be applied to customer profiles. Custom attributes allow storing additional structured data on customers beyond th...

Create Customer Group

Tool to create a new customer group for a business. Use when you need to organize customers into groups for targeted marketing or segmentation.

Create Dispute Evidence File

Tool to upload a file as dispute evidence. Use when you need to attach supporting documents (PDF, image, etc.) to an existing dispute. Use after creating or retrieving a dispute.

Create Dispute Evidence Text

Upload text evidence for a dispute challenge. Use this to submit textual information (up to 500 characters) that supports your case in a payment dispute. After uploading all evidence, you must call SubmitEvidence to finalize the dispute...

Create Invoice Attachment

Upload and attach a file to a Square invoice. Use this action to add supplementary documents (receipts, contracts, supporting documentation) to an existing invoice. Attachments can only be added to invoices in DRAFT, SCHEDULED, UNPAID, o...

Create Location

Tool to create a new business location in a Square account. Use when you need to add a new physical or mobile location for the merchant.

Create Location Custom Attribute Definition

Tool to create a location-related custom attribute definition. Use when you need to define new custom attributes for Square location objects to store additional business-specific data.

Delete Customer

Tool to delete a Square customer profile. Use when you need to permanently remove a customer record from Square.

Delete Customer Custom Attribute

Tool to delete a custom attribute from a customer profile. Use when you need to remove custom data associated with a specific customer. Requires the CUSTOMERS_WRITE OAuth permission scope.

Delete Customer Custom Attribute Definition

Tool to delete a customer-related custom attribute definition. Use when you need to remove a custom attribute definition that is no longer needed. This action requires CUSTOMERS_WRITE permission.

Delete Customer Group

Tool to delete a customer group by its ID. Use when you need to permanently remove a customer group from Square.

Bulk Delete Customers

Tool to bulk delete customer profiles from Square. Use when you need to delete multiple customer profiles at once (1-100 customers per request). Each successful deletion returns an empty object; failed deletions include error details. No...

Delete Dispute Evidence

Removes a specific piece of evidence from a dispute. Evidence that is removed will NOT be sent to the bank. This action requires the DISPUTES_WRITE permission scope. Important: You CANNOT remove evidence after it has been submitted to th...

Delete Invoice

Tool to delete a Square invoice (only DRAFT invoices can be deleted).

Delete Invoice Attachment

Tool to delete an attachment from a Square invoice. Endpoint: DELETE /v2/invoices/{invoice_id}/attachments/{attachment_id}

Delete Location Custom Attribute

Tool to delete a custom attribute from a location. Use when you need to remove custom data associated with a specific business location. Requires the MERCHANT_PROFILE_WRITE OAuth permission scope.

Delete Location Custom Attribute Definition

Tool to delete a location-related custom attribute definition. Once deleted, the custom attribute definition cannot be used to add custom attributes to locations. Use when you need to remove obsolete or incorrect custom attribute definit...

Delete Locations Custom Attributes (Batch)

Tool to delete custom attributes from multiple locations in a single batch request. Use when you need to remove custom metadata from multiple business locations efficiently. To delete custom attributes owned by other applications, the at...

Delete Merchant Custom Attribute

Tool to delete a custom attribute from a merchant profile. Use when you need to remove custom data associated with a specific merchant. Requires the MERCHANT_PROFILE_WRITE OAuth permission scope.

Delete Merchant Custom Attribute Definition

Tool to delete a merchant-related custom attribute definition. Once deleted, the custom attribute definition cannot be used to add custom attributes to merchants. Use when you need to remove obsolete or incorrect custom attribute definit...

Delete Merchants Custom Attributes (Batch)

Tool to delete custom attributes from multiple merchants in a single batch request. Use when you need to remove custom metadata from merchant profiles efficiently. To delete custom attributes owned by other applications, the attribute's...

Delete Webhook Subscription

Permanently deletes a webhook subscription by its ID. Once deleted, the subscription will no longer receive event notifications. This action cannot be undone. Note: Webhook subscriptions are application-level resources and require person...

Get Business Booking Profile

Tool to retrieve the business booking profile for a Square merchant via GraphQL. Use when you need to check if bookings are enabled, view cancellation policies, or access booking configuration settings. This is an alpha feature.

Get Current Merchant

Tool to retrieve merchant information associated with the access token using Square's GraphQL API. Use when you need to obtain the merchant ID required for other GraphQL queries, or to get merchant details like business name, status, cur...

Get Customer Custom Attribute

Retrieves a custom attribute from a customer profile in Square. Use this when you need to access specific custom data associated with a customer, such as preferences, external IDs, or other merchant-defined information. Requires CUSTOMER...

Get Customer Custom Attribute Definition

Tool to retrieve a customer-related custom attribute definition from Square. Use when you need to fetch the schema, visibility, or metadata of a specific custom attribute definition by its key.

Get Customers via GraphQL

Tool to retrieve customer profiles from Square Customer Directory using GraphQL API. Use when you need to fetch customer information including name, contact details, and profile data for a specific merchant. Requires merchant ID filter.

Get Dispute Evidence

Retrieves detailed information about a specific piece of evidence that was uploaded for a dispute. Use this action to: - Get metadata about evidence (file details, upload time, evidence type) - Verify evidence was uploaded successfully -...

Get Invoice

Retrieves detailed information about a specific Square invoice by its ID. Returns the complete invoice object including payment requests, recipient details, accepted payment methods, custom fields, attachments, and current status. Use th...

Get Merchant

Tool to retrieve detailed information about a specific Square merchant by ID. Use when you need to fetch merchant profile data including business name, country, currency, and main location ID. Use 'me' as the merchant_id to retrieve the...

Get Online Checkout Location Settings

Tool to retrieve location-level settings for Square online checkout. Use when you need to get checkout configuration including customer notes, policies, branding, and tipping options for a specific location.

List Channels

Tool to list requested channels from Square. Use when you need to retrieve channel information for a specific reference type, reference ID, or status.

List Customer Custom Attribute Definitions

Tool to list customer-related custom attribute definitions from Square. Use when you need to discover available custom attributes that can be attached to customer profiles.

List Customer Custom Attribute Definitions (GraphQL)

Tool to retrieve customer custom attribute definitions via Square's GraphQL API. Use when you need to discover available custom attributes and their metadata for customer profiles. Alpha feature.

List Customer Custom Attributes

Tool to list custom attributes for a customer profile. Use when you need to retrieve all custom data associated with a specific customer, including optional definitions that provide metadata about each attribute.

List Customer Groups

Tool to retrieve the list of customer groups of a business. Use when you need to discover customer group IDs or list all customer groups for segmentation and targeting purposes.

List Customers

Tool to retrieve customer profiles associated with a Square account. Use when you need to list customers for CRM, reporting, or customer management purposes. Only returns profiles with public information (given_name, family_name, company...

List Customer Segments

Tool to retrieve the list of customer segments of a business. Use when you need to discover customer segment IDs for targeting or filtering customer groups in Square.

List Dispute Evidence

Tool to list evidence items associated with a given dispute. Endpoint: GET /v2/disputes/{dispute_id}/evidence

List Invoices

Tool to list invoices for a Square location.

Plus 48 more Square actions your agent can call.

How to connect Square

You authorize Square once from your dashboard. Operator holds the connection and refreshes the access tokens on its own, so your agent keeps working with Square without you signing in again. The same setup unlocks every other app your agent can reach, so you only do it once.

When you are ready, the get started guide walks through standing up your OpenClaw agent.

Common questions about Square

How do I connect Square to Operator?: You authorize Square once from your Operator dashboard. Operator holds the connection and refreshes the access token for you, so your agent keeps working with Square without you signing in again.
Can my agent manage my store in Square?: Yes. It can read and update products, orders, and customers, and report on what is happening. Ask for the day's orders or to adjust stock and it runs the matching Square actions, so you run the store from a chat instead of the admin panel.
Do I need to write code or manage Square API keys?: No code and no API keys. You authorize Square through a normal sign in and Operator handles the connection, so there is nothing to wire up or host.
Can my agent use Square together with my other apps?: Yes. The same agent reaches every app you connect, so it can move between Square and tools like Shopify, Cloudcart, Baselinker in one job, reading from one and acting in another without you wiring anything between them.