Square

Manage Square: payments, refunds, orders, customers, catalog, invoices. Exposes 51 actions covering the full API surface the agent needs - read and write.

What it can do

Method	What it does
square_customers_list	List all customers - GET /customers.
square_customer_get	Get one customer by ID - GET /customers/{customer_id}.
square_customer_create	Create a customer - POST /customers.
square_customer_update	Update a customer - PUT /customers/{customer_id}.
square_customer_delete	Delete a customer - DELETE /customers/{customer_id}.
square_customers_search	Search customers by email, phone, name, created_at, updated_at - POST /customers/search.
square_payments_list	List payments - GET /payments.
square_payment_get	Get one payment - GET /payments/{payment_id}.
square_payment_create	Create a payment - POST /payments.
square_payment_refund	Refund a payment (full or partial) - POST /payments/{payment_id}/refunds.
square_payment_complete	Complete a delayed payment - POST /payments/{payment_id}/complete.
square_orders_list	List orders for a location - GET /orders.
square_order_get	Get one order - GET /orders/{order_id}.
square_order_create	Create an order - POST /orders.
square_order_update	Update an order - PUT /orders/{order_id}.
square_order_request_payment	Request a payment link for an order - POST /orders/{order_id}/payment_link.
square_catalog_list	List all catalog objects (items, modifiers, taxes, etc.) - GET /catalog/list.
square_catalog_get	Get one catalog object (item, modifier, tax, etc.) - GET /catalog/object/{object_id}.
square_catalog_search	Search catalog objects by text, category, etc.
square_item_create	Create a catalog item - POST /catalog/object.
square_item_update	Update catalog object - PUT /catalog/object.
square_invoices_list	List invoices for a location - GET /invoices.
square_invoice_get	Get one invoice - GET /invoices/{invoice_id}.
square_invoice_create	Create an invoice - POST /invoices.
square_invoice_update	Update an invoice - PUT /invoices/{invoice_id}.
square_invoice_publish	Publish/send an invoice - POST /invoices/{invoice_id}/publish.
square_invoice_cancel	Cancel an invoice - POST /invoices/{invoice_id}/cancel.
square_locations_list	List all merchant locations - GET /locations.
square_location_get	Get one location - GET /locations/{location_id}.
square_location_create	Create a location - POST /locations.
square_location_update	Update a location - PUT /locations/{location_id}.
square_subscriptions_list	List subscriptions - GET /subscriptions.
square_subscription_get	Get one subscription - GET /subscriptions/{subscription_id}.
square_subscription_create	Create a subscription - POST /subscriptions.
square_subscription_update	Update a subscription - PUT /subscriptions/{subscription_id}.
square_subscription_resume	Resume a paused subscription - POST /subscriptions/{subscription_id}/resume.
square_subscription_pause	Pause a subscription - POST /subscriptions/{subscription_id}/pause.
square_subscription_cancel	Cancel a subscription - POST /subscriptions/{subscription_id}/cancel.
square_loyalty_programs_list	List loyalty programs - GET /loyalty/programs.
square_loyalty_account_get	Get one loyalty account - GET /loyalty/accounts/{account_id}.
square_loyalty_accounts_search	Search loyalty accounts - POST /loyalty/accounts/search.
square_loyalty_account_create	Create a loyalty account - POST /loyalty/accounts.
square_loyalty_points_adjust	Adjust loyalty points - POST /loyalty/accounts/{account_id}/adjust.
square_loyalty_rewards_list	List loyalty rewards for an account - GET /loyalty/accounts/{account_id}/rewards.
square_loyalty_reward_redeem	Redeem a loyalty reward - POST /loyalty/rewards/{reward_id}/redeem.
square_refunds_list	List refunds - GET /refunds.
square_refund_get	Get one refund - GET /refunds/{refund_id}.
square_refunds_for_payment	List all refunds for a payment - GET /refunds?payment_id={payment_id}.
square_disputes_list	List disputes (chargebacks, disputes) - GET /disputes.
square_dispute_get	Get one dispute - GET /disputes/{dispute_id}.
square_dispute_add_evidence	Add evidence to a dispute - POST /disputes/{dispute_id}/evidence.

How to get credentials

This connector uses OAuth 2.0. In FlyMyAI, open the tool and click Connect - you'll be redirected to Square to authorize, then back to FlyMyAI. There is no API key to paste.

The OAuth app must be registered by FlyMyAI for this provider. If you see "connection not configured", the provider's client credentials are still being set up - check back shortly.

Fields to fill in FlyMyAI

FlyMyAI field	Where it comes from
(none)	Connect via OAuth - nothing to paste.

Troubleshooting

• 401 Unauthorized / 403 Forbidden - the OAuth connection expired or was revoked - reconnect.
• 429 Too Many Requests - you hit the provider rate limit; retry after a short backoff.
• Unexpected 4xx on writes - double-check required fields; the agent confirms before write actions.

Links

• Square API documentation

❤️We love our partners - FlyMy.AI builds with the best. Thanks, Square!