Square

Live 137 Actions 96 Events

Square Integration for AI Agents

Connect your AI agent to 137 Square actions via MCP, A2A, or SDK, with agent authentication, tool-calling execution, and security built-in, plus 96 events to subscribe to.

Start Free Book Demo Square MCP Server

Square AI Agent Actions

137 production-ready actions for your agent to do more on Square.

Read the Square docs

137 Actions

List Payments - Retrieve a paginated list of payments taken by the account

Create Payment - Create a payment using a payment source such as a card or gift card

Get Payment - Retrieve details for a specific payment by ID

Update Payment - Update a payment with APPROVED status to modify tip or amount

Cancel Payment - Cancel (void) a payment by its ID

Cancel Payment By Idempotency Key - Cancel a payment using the original idempotency key when the payment ID is unknown

Complete Payment - Complete (capture) a payment that was created with autocomplete set to false

List Payment Refunds - Retrieve a paginated list of refunds for the account

Refund Payment - Refund a payment, either fully or partially

Get Payment Refund - Retrieve details of a specific refund by ID

Create Order - Create a new order for a location

Search Orders - Search for orders across one or more locations with filters

Retrieve Order - Retrieve an order by its ID

Update Order - Update an open order by adding, replacing, or deleting fields

Pay Order - Pay for an order using one or more approved payments

Calculate Order - Preview order pricing without creating an order

Batch Retrieve Orders - Retrieve multiple orders by their IDs in a single request

Clone Order - Create a new order by cloning an existing order

List Customers - Retrieve a paginated list of all customer profiles for the account

Create Customer - Create a new customer profile for the business

Search Customers - Search customer profiles by phone, email, name, or custom attributes

Retrieve Customer - Retrieve a specific customer profile by ID

Update Customer - Update an existing customer profile

Delete Customer - Delete a customer profile from the business

Add Group To Customer - Add a group membership to a customer profile

Remove Group From Customer - Remove a group membership from a customer profile

List Customer Groups - Retrieve a list of all customer groups for the business

Create Customer Group - Create a new customer group for the business

Retrieve Customer Group - Retrieve a specific customer group by ID

Update Customer Group - Update an existing customer group's name

Delete Customer Group - Delete a customer group from the business

Bulk Create Customers - Create up to 100 customer profiles in a single request

Bulk Retrieve Customers - Retrieve up to 100 customer profiles by ID in a single request

Bulk Update Customers - Update up to 100 customer profiles in a single request

Bulk Delete Customers - Delete up to 100 customer profiles in a single request

List Customer Segments - Retrieve a list of all customer segments for the business

Retrieve Customer Segment - Retrieve a specific customer segment by ID

List Catalog - Retrieve a paginated list of all catalog objects for the account

Search Catalog Objects - Search for catalog objects of any type (items, categories, taxes, discounts, etc.) using advanced query filters

Search Catalog Items - Search specifically for catalog items and item variations only (not taxes, categories, or discounts) by text, category, location, or custom attributes

Retrieve Catalog Object - Retrieve a single catalog object by ID

Upsert Catalog Object - Create or update a single catalog object

Delete Catalog Object - Delete a single catalog object and its children

Batch Upsert Catalog Objects - Create or update up to 10,000 catalog objects in a single request

Batch Retrieve Catalog Objects - Retrieve multiple catalog objects by their IDs in a single request

Batch Delete Catalog Objects - Delete multiple catalog objects in a single request

Retrieve Inventory Count - Retrieve current inventory counts for a specific catalog object

Batch Retrieve Inventory Counts - Retrieve current inventory counts for multiple catalog objects at specific locations

Batch Retrieve Inventory Changes - Retrieve a list of inventory changes for catalog objects at specific locations

Retrieve Inventory Adjustment - Retrieve a specific inventory adjustment by its ID

Retrieve Inventory Physical Count - Retrieve a specific inventory physical count record by its ID

Batch Change Inventory - Apply adjustments and counts to catalog object quantities

List Locations - Retrieve all seller locations for the account

Create Location - Create a new location for the seller account

Retrieve Location - Retrieve details of a specific location by ID

Update Location - Update an existing location's settings and information

List Merchants - Retrieve the merchant profile for the account

Retrieve Merchant - Retrieve a specific merchant's profile by ID

List Payouts - Retrieve a paginated list of all payouts for the seller's default or specified location

Get Payout - Retrieve details of a specific payout by its ID

List Payout Entries - Retrieve all payout entries for a specific payout

List Invoices - Retrieve a list of invoices for a given location

Create Invoice - Create a draft invoice for an order

Search Invoices - Search for invoices by location, customer, or status

Get Invoice - Retrieve an invoice by its ID

Update Invoice - Update a draft or scheduled invoice

Delete Invoice - Delete a draft invoice

Publish Invoice - Publish a draft invoice to send it to the customer

Cancel Invoice - Cancel a published invoice

Create Subscription - Enroll a customer in a subscription plan

Search Subscriptions - Search for subscriptions by customer, location, or plan

Retrieve Subscription - Retrieve a specific subscription by ID

Update Subscription - Modify or clear field values on an active subscription

Cancel Subscription - Schedule a cancellation for an active subscription

List Subscription Events - Retrieve a paginated list of events for a specific subscription

Resume Subscription - Resume a paused or canceled subscription

List Cards - Retrieve a list of saved payment cards (credit/debit cards on file, not gift cards) for the account

Create Card - Add a card on file to an existing customer or merchant

Retrieve Card - Retrieve details of a specific card on file by ID

Disable Card - Disable a card on file to prevent further charges

List Gift Cards - Retrieve a list of gift cards for the account

Create Gift Card - Create a digital gift card or register a physical gift card

Retrieve Gift Card - Retrieve a gift card by its ID

Retrieve Gift Card From GAN - Retrieve a gift card using the gift card account number (GAN)

Link Customer To Gift Card - Link a customer to a gift card to associate it with their account

Unlink Customer From Gift Card - Unlink a customer from a gift card to remove the association

Create Gift Card Activity - Create an activity (activate, load, redeem, adjust, etc.) on a gift card

List Gift Card Activities - Retrieve a list of gift card activities for a specific gift card or across all gift cards

Create Team Member - Create a new team member for the seller account

Search Team Members - Search for team members by location, status, or other criteria

Retrieve Team Member - Retrieve a team member by ID

Update Team Member - Update an existing team member's information

List Jobs - Retrieve a list of all jobs defined for the seller account

Create Job - Create a new job definition for the seller account

Retrieve Job - Retrieve a specific job definition by its ID

Update Job - Update an existing job definition by its ID

Retrieve Wage Setting - Retrieve the wage setting for a team member

Update Wage Setting - Create or update the wage setting for a team member

Bulk Create Team Members - Create multiple team members in a single request

Bulk Update Team Members - Update multiple team members in a single request

List Break Types - Retrieve a list of all break types for the seller account

Create Break Type - Create a new break type for team member shifts

Retrieve Break Type - Retrieve a specific break type by ID

Search Timecards - Search for timecard records with filters for team member and date range

Retrieve Timecard - Retrieve a specific timecard by ID

Create Timecard - Create a new timecard for a team member at a location

Update Break Type - Update an existing break type by ID

Delete Break Type - Delete a break type by ID

Update Timecard - Update an existing timecard by ID

Delete Timecard - Delete a timecard by ID

List Disputes - Retrieve a list of disputes associated with the account

Retrieve Dispute - Retrieve details about a specific dispute by ID

Accept Dispute - Accept the loss on a dispute without submitting evidence

List Dispute Evidence - Retrieve all evidence submitted for a dispute

Submit Evidence - Submit collected evidence to contest a dispute

List Bank Accounts - Retrieve a list of bank accounts linked to the Square account

Get Bank Account - Retrieve details of a specific bank account by ID

Create Dispute Evidence Text - Upload text-based evidence to contest a dispute

Retrieve Dispute Evidence - Retrieve metadata for a specific piece of dispute evidence

Delete Dispute Evidence - Remove a specific piece of evidence from a dispute before submission

List Payment Links - Retrieve a list of all payment links for the account

Create Payment Link - Create a Square-hosted checkout page with a shareable payment link

Retrieve Payment Link - Retrieve a specific payment link by its token ID

Update Payment Link - Update an existing payment link's settings

Delete Payment Link - Delete a payment link permanently

Get Unified Credentials - Return the authenticated Square connection's identity (merchant business name), granted OAuth scopes, and auth_type ("oauth"), mapped to the IAM unified credentials schema. Wraps Square's POST /oauth2/token/status for scope/identity introspection plus GET /v2/merchants for the merchant business name.

IAM Auth Test - Validate the current Square OAuth access token and return the raw, unmapped token status payload (scopes[], expires_at, merchant_id, client_id). Bypasses the unified IAM credentials schema — use this for debugging scope mismatches, token expiry, or revocation.

List Unified Groups - List Square locations mapped to the IAM unified group schema. Each location represents a physical workplace (store, mobile pop-up, or online presence) to which team members can be assigned via the assigned_locations field. Returns id, name, status, address, and merchant_id (mapped to organization_id).

Get Unified Group - Retrieve a single Square location by id, mapped to the IAM unified group schema. Field coverage matches unified_list_groups exactly.

List Unified Organizations - Return the Square merchant for the current connection mapped to the IAM unified organization schema. Square is single-tenant per OAuth token — exactly one organization is returned, representing the connected merchant.

Get Unified Organization - Retrieve a single Square merchant by id, mapped to the IAM unified organization schema. Square is single-tenant per OAuth token — this action always returns the caller's connected merchant.

List Unified Resource Types - List unified resource types in Square.

List Unified Resource Users - List Square team members assigned to a specific location (resource_type="location"), mapped to the IAM unified user schema. Each member carries both a workspace-scoped role and a location-scoped role. Wraps POST /v2/team-members/search filtered by location_ids.

List Unified Roles - Return the two stable workspace-level IAM roles (owner / team_member) synthesized from Square's is_owner flag on team members. The role set is static, closed, and matches the role ids embedded in IamUser.roles[] on this connector.

Get Unified Role - Retrieve a single synthesized Square IAM role by its stable key. Known keys are "owner" and "team_member"; any other id returns a generic role record with type unmapped_value rather than erroring.

List Unified Users - List Square team members mapped to the IAM unified user schema. Each member is annotated with a workspace-scoped role synthesized from the is_owner flag (owner / team_member), employment status (enabled / disabled), contact info, and reference data. Cursor-paginated via the Square Team API search endpoint.

Get Unified User - Retrieve a single Square team member by team member id, mapped to the IAM unified user schema. Field coverage matches unified_list_users; one synthesized workspace-scoped role per member based on the is_owner flag.

Square Webhook Events

96 real-time Square events your AI agent can subscribe to.

Webhooks for AI agents Read the Square docs

96 Events

Unmapped Event Acknowledges Square events this connector does not map.
Payment Created Fires when a payment is created.
Payment Updated Fires when a payment field changes, such as status or card_details.status.
Refund Created Fires when a refund is created.
Refund Updated Fires when a refund is updated, typically when its status changes on completion.
Card Created Fires when a card on file is created or imported.
Card Automatically Updated Fires when Square automatically updates a card expiration date or PAN, or adds or removes an issuer alert.
Card Updated Fires when the seller updates a card in the Square Dashboard.
Card Disabled Fires when a card on file is disabled.
Card Forgotten Fires when a card is GDPR forgotten or vaulted.
Dispute Created Fires when a dispute is created.
Dispute State Updated Fires when the state of a dispute changes, including the WON or LOST resolution reported by the bank.
Dispute Evidence Created Fires when evidence is added to a dispute.
Dispute Evidence Deleted Fires when evidence is removed from a dispute.
Payout Sent Fires when a payout is sent.
Payout Paid Fires when a payout is completed.
Payout Failed Fires when a payout fails.
Bank Account Created Fires when a bank account is linked to the Square account.
Bank Account Verified Fires when Square sets the status of a bank account to VERIFIED.
Bank Account Disabled Fires when Square sets the status of a bank account to DISABLED.
Gift Card Created Fires when a digital gift card is created or a physical gift card is registered.
Gift Card Updated Fires when the balance, state or linked customers of a gift card change.
Gift Card Customer Linked Fires when a customer is linked to a gift card.
Gift Card Customer Unlinked Fires when a customer is unlinked from a gift card.
Gift Card Activity Created Fires when a gift card activity is created.
Gift Card Activity Updated Fires when a REDEEM or IMPORT gift card activity is updated.
Order Created Fires when an order is created by a Square product or an application.
Order Updated Fires when an order is updated through UpdateOrder or by the seller.
Order Fulfillment Updated Fires when an order fulfillment is created or updated.
Invoice Created Fires when a draft invoice is created.
Invoice Updated Fires when an invoice changes, including after it is published or canceled.
Invoice Published Fires when an invoice is published, including invoices scheduled for later processing.
Invoice Payment Made Fires when a payment is made for an invoice.
Invoice Scheduled Charge Failed Fires when a scheduled automatic invoice payment fails.
Invoice Canceled Fires when an invoice is canceled.
Invoice Refunded Fires when a refund is processed for an invoice.
Invoice Deleted Fires when a draft invoice is deleted.
Subscription Created Fires when a subscription is created.
Subscription Updated Fires when a subscription is updated.
Catalog Version Updated Fires when the catalog is updated.
Inventory Count Updated Fires when the quantity of a catalog item variation changes.
Customer Created Fires when a customer profile is created, including when profiles are merged.
Customer Updated Fires when an attribute on a customer profile changes, except segment_ids.
Customer Deleted Fires when a customer profile is deleted, including when profiles are merged.
Location Created Fires when a location is created.
Location Updated Fires when a location is updated.
Online Checkout Location Settings Updated Fires when online checkout location settings are updated.
Online Checkout Merchant Settings Updated Fires when online checkout merchant settings are updated.
Team Member Created Fires when a team member is created.
Team Member Updated Fires when a team member is updated.
Team Member Wage Setting Updated Fires when the wage setting of a team member is updated.
Job Created Fires when a job is created.
Job Updated Fires when a job is updated.
Timecard Created Fires when a timecard is created at the start of a shift.
Timecard Updated Fires when a timecard is updated.
Timecard Deleted Fires when a timecard is deleted.
Scheduled Shift Created Fires when a scheduled shift is created.
Scheduled Shift Updated Fires when a scheduled shift is updated.
Scheduled Shift Published Fires when a scheduled shift is published.
Scheduled Shift Deleted Fires when a scheduled shift is permanently deleted.
OAuth Authorization Revoked Fires when the seller revokes all access and refresh tokens granted to the application.
Customer Custom Attribute Definition Owned Created Fires when a customer custom attribute definition owned by the application is created.
Customer Custom Attribute Definition Owned Updated Fires when a customer custom attribute definition owned by the application is updated.
Customer Custom Attribute Definition Owned Deleted Fires when a customer custom attribute definition owned by the application is deleted.
Customer Custom Attribute Owned Updated Fires when a customer custom attribute owned by the application is created or updated.
Customer Custom Attribute Owned Deleted Fires when a customer custom attribute owned by the application is deleted.
Customer Custom Attribute Definition Visible Created Fires when a customer custom attribute definition visible to the application is created.
Customer Custom Attribute Definition Visible Updated Fires when a customer custom attribute definition visible to the application is updated.
Customer Custom Attribute Definition Visible Deleted Fires when a customer custom attribute definition visible to the application is deleted.
Customer Custom Attribute Visible Updated Fires when a customer custom attribute visible to the application is created or updated.
Customer Custom Attribute Visible Deleted Fires when a customer custom attribute visible to the application is deleted.
Booking Custom Attribute Definition Owned Created Fires when a booking custom attribute definition owned by the application is created.
Booking Custom Attribute Definition Owned Updated Fires when a booking custom attribute definition owned by the application is updated.
Booking Custom Attribute Definition Owned Deleted Fires when a booking custom attribute definition owned by the application is deleted.
Booking Custom Attribute Owned Updated Fires when a booking custom attribute owned by the application is created or updated.
Booking Custom Attribute Owned Deleted Fires when a booking custom attribute owned by the application is deleted.
Booking Custom Attribute Definition Visible Created Fires when a booking custom attribute definition visible to the application is created.
Booking Custom Attribute Definition Visible Updated Fires when a booking custom attribute definition visible to the application is updated.
Booking Custom Attribute Definition Visible Deleted Fires when a booking custom attribute definition visible to the application is deleted.
Booking Custom Attribute Visible Updated Fires when a booking custom attribute visible to the application is created or updated.
Booking Custom Attribute Visible Deleted Fires when a booking custom attribute visible to the application is deleted.
Booking Created Fires when a booking is created.
Booking Updated Fires when a booking is updated or canceled, through the API, the Square Dashboard or the seller booking site.
Loyalty Account Created Fires when a loyalty account is created for a buyer.
Loyalty Account Updated Fires when a loyalty account is updated, for example its phone number or point balance.
Loyalty Account Deleted Fires when a loyalty account is deleted.
Loyalty Event Created Fires when a balance-changing loyalty event occurs, such as points accumulated or a reward redeemed.
Loyalty Program Created Fires when a loyalty program is created in the Square Dashboard.
Loyalty Program Updated Fires when a loyalty program is updated in the Square Dashboard.
Loyalty Promotion Created Fires when a loyalty promotion is created.
Loyalty Promotion Updated Fires when a loyalty promotion is updated, for example canceled.
Terminal Checkout Created Fires when a Terminal checkout request is created.
Terminal Checkout Updated Fires when the status of a Terminal checkout changes.
Terminal Refund Created Fires when a Terminal refund request is created.
Terminal Refund Updated Fires when the status of a Terminal refund changes.
Device Code Paired Fires when a Square Terminal is paired with a Terminal API device code.

Do More, Build Less

Integration Infrastructure for Square AI Agents

Multiple Interfaces

Access integrations via API, AI SDKs, MCP & A2A.

Square MCP server

Managed Authentication

Pre-built authentication UI.

Agent auth

Falcon Engine

Every Square action runs on Falcon.

Agent Execution Engine

StackOne Defender

88.7% prompt injection detection.

Prompt injection defense

Start Free Book a Demo

"What impressed us most about StackOne is its ambition and clarity. They're creating infrastructure that modern software and the entire AI agent ecosystem can rely on. The depth of secure integrations, the pace of delivery, and the team's foresight into AI's future uniquely position StackOne to redefine this category."

Luna Schmid, Partner at GV

"We've been impressed by how quickly and deeply StackOne integrates with complex enterprise systems -- and now, with their focus on agent-to-agent interoperability, they're unlocking even more powerful use cases for customers. StackOne delivers all of the above in a universal layer -- without compromise."