# Square MCP connector

The Square connector brings payments, refunds, and orders into Elaichi, so once Square is connected your team can look up a charge, issue a refund, or build an order from Claude, ChatGPT, Cursor, or the Elaichi Agent, each person signed in as themselves.

Source: https://elaichi.ai/connectors/square/

## Facts

| | |
| --- | --- |
| Application | Square |
| Category | Payment Gateway |
| AI tools | 287 |
| Authentication | Connects over OAuth |
| Needs your own OAuth app | Yes |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. 287 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` |

## What you can ask once Square is connected

- Show Square payments over 500 dollars from last week.
- Which Square orders have open refunds right now?
- Summarize Square refund totals by location this month.

## Connect Square in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick Square.
2. Optionally set Share with, then press Connect.
3. Supply your own Square app, then approve. Square needs an OAuth app you register yourself, so bring its client ID and secret. One person does this once for the organization.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Square tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## Connect Square to Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## Connect Square to ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

## Connect Square to Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## Connect Square to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Only Read is granted by default, which is not enough to call a Square tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone.

## What teams do with Square through Elaichi

### Find the charge a customer is asking about

Support. A customer emails about a payment they do not recognize. Pull up the Square payment by amount, date, or card details and tell them exactly what it was for.

### Issue a refund without leaving the conversation

Support. When a return is approved, create the Square refund against the original payment and note the reason, all in the same thread where you are helping the customer.

### Reconcile yesterday's payments and refunds

Finance. List every Square payment and refund for a date range, spot the ones that failed or were canceled, and get a clean picture before closing the books.

### Build and price an order before it is paid

Operations. Create a Square order for a phone or catering request, calculate the total with taxes and discounts, and take the payment once the customer confirms.

### Repeat a standing order in one step

Operations. Clone last week's Square order for a regular customer, adjust the quantities that changed, and send it through to payment.

### Tag orders with the details you track

Leadership. Add custom fields to Square orders, such as event name or sales channel, so every order carries the context your reports need.

## Frequently asked questions

### How do I connect Square to Claude?

Connect Square in Elaichi first, then in Claude go to Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp as the endpoint. Square requires an OAuth application registered inside Square, so one person on your team creates it in the Square developer dashboard and enters its client ID and secret in Elaichi once. After that, everyone else simply signs in with their own Square login when prompted and never sees those details.

### Does Square work with ChatGPT and Cursor as well as Claude?

Yes. Once Square is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent. You connect Square once and it is available everywhere your team already works.

### What can an AI agent actually do with my Square data?

With Square connected, an agent can look up a payment, list the payments and refunds from a given day, create or cancel a payment, issue a refund, and build, price, clone, or pay a Square order. It can also manage the custom fields you attach to orders. Short, specific asks such as "refund payment ending 4421 from Tuesday" work better than long paragraphs.

### Does connecting Square give the AI access to every location and every transaction?

No. Everything an agent does in Square runs under the Square permissions of the person who signed in, so it can only see the locations and transactions that person can already see. Elaichi can narrow that further, for example to read-only or to a subset of actions, but it can never grant more than the person already has in Square.

### Can my team share one Square connection?

Yes. One person connects Square in Elaichi and shares the connection with a team, and nobody else needs to handle the client ID, secret, or any other credential. Each teammate still signs in as themselves, so the audit log records who issued a refund or changed an order, not just that the shared Square connection did.

### Can I stop an agent from deleting or changing things in Square?

Yes. Restrictions in Elaichi work per action, so you can allow reading Square payments and orders while blocking refunds, cancellations, or edits. A blocked action is never shown to Claude, ChatGPT, or any other client at all, so no prompt, however worded, can reach it.

### What happens to a Square connection when someone leaves?

When you offboard a person in Elaichi, their access to Square through every connected client ends immediately. If they connected a shared Square connection, it keeps working for everyone else on the team. If you ever want Square gone entirely, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor, and every other client at the same time.

## All 287 Square tools

Every tool below is callable through https://api.elaichi.ai/mcp once Square is connected, subject to the toolbox it is in and the restrictions on the caller.

- **List all Square payments** (List). List Square payments taken by the seller. Returns: id, amount_money, status, source_type, created_at.
- **Get single Square payment by ID** (Get). Get a Square payment by id. Returns the full payment object including amount_money, status, source_type, and receipt details. Required: id.
- **Create a Square payment** (Create). Create a Square payment by charging a payment source (card nonce, card on file, or other). Returns the created payment object including id, status, and amount_money. Requires source_id, idempotency_key, and amount_money.
- **Update a Square payment by ID** (Update). Update a Square payment by id (e.g., adjust amounts, tip, or app fee on a delayed-capture payment). Returns the updated payment object. Requires id and idempotency_key.
- **Square payments cancel** (Cancel). Cancel an uncompleted Square payment, releasing any held funds. Returns the canceled payment object with status CANCELED. Required: payment_id.
- **Square payments complete** (Complete). Complete (capture) an authorized Square payment. Returns the completed payment object with status COMPLETED. Required: payment_id.
- **Square payments cancel by idempotency key** (Cancel). Cancel a Square payment by the idempotency_key used when it was created, useful when the original create call timed out. Returns an empty object on success. Required: idempotency_key.
- **List all Square refunds** (List). List payment refunds in Square. Returns an array of refund objects including id, amount_money, status, and created_at.
- **Get single Square refund by ID** (Get). Get a Square payment refund by id. Returns the refund object including amount_money, status, payment_id, and created_at. Required: id.
- **Create a Square refund** (Create). Create a refund for a Square payment. Returns the created refund object including id, amount_money, status, and payment_id.
- **Create a Square order** (Create). Create a new order in Square. Returns the created order including its id, location_id, line_items, totals, and state. Requires order with a location_id.
- **List all Square orders** (List). Search Square orders across one or more locations. Returns: orders matching the query with their id, location_id, line_items, totals, and state. Requires location_ids.
- **Get single Square order by ID** (Get). Get a Square order by id. Returns the order object including id, location_id, line_items, totals, tenders, fulfillments, and state.
- **Update a Square order by ID** (Update). Update an open Square order by id. Returns the updated order including its line_items, totals, and version. Requires id and order with the current version.
- **Square orders pay** (Action). Pay for a Square order using one or more payment IDs to settle the balance. Returns the paid order with its state set to COMPLETED. Requires order_id, idempotency_key, and payment_ids.
- **Square orders clone** (Action). Clone an existing Square order as a draft to use as a template for a new order. Returns the newly created order with a new id. Requires order_id.
- **Square orders calculate** (Action). Calculate totals, taxes, and discounts for a Square order without persisting it. Returns the order with computed total_money, total_tax_money, and total_discount_money. Requires order with a location_id.
- **Square orders batch get** (Get). Retrieve multiple Square orders in one call by their ids. Returns: orders array with each order's id, location_id, line_items, totals, and state. Requires location_id and order_ids.
- **List all Square order custom attribute definitions** (List). List order custom attribute definitions in Square. Returns the custom attribute definitions visible to the caller, including each definition's key, name, description, schema, and visibility.
- **Get single Square order custom attribute definition by ID** (Get). Get a single order custom attribute definition in Square by id. Returns the definition including its key, name, description, schema, visibility, and version. Required: id.
- **Create a Square order custom attribute definition** (Create). Create an order custom attribute definition in Square. Returns the created custom attribute definition including its key, name, schema, visibility, and version. Required: custom_attribute_definition.
- **Update a Square order custom attribute definition by ID** (Update). Update an order custom attribute definition in Square by id. Returns the updated custom attribute definition. Required: id, custom_attribute_definition.
- **Delete a Square order custom attribute definition by ID** (Delete). Delete an order custom attribute definition in Square by id. Required: id.
- **List all Square order custom attributes** (List). List custom attributes set on a Square order. Returns the custom_attributes array with each attribute's key, value, and metadata. Required: order_id.
- **Get single Square order custom attribute by ID** (Get). Get a single custom attribute set on a Square order by id. Returns the custom_attribute object with its key, value, and metadata. Required: order_id and id.
- **Square order custom attributes upsert** (Upsert). Create or update a custom attribute on a Square order. Returns the resulting custom_attribute object. Required: order_id and custom_attribute_key.
- **Delete a Square order custom attribute by ID** (Delete). Delete a custom attribute from a Square order by key. Returns an empty response on success. Required: order_id and custom_attribute_key.
- **List all Square catalog objects** (List). List catalog objects in Square. Returns an array of catalog objects with their id, type, version, and type-specific data.
- **Get single Square catalog object by ID** (Get). Get a Square catalog object by id. Returns the catalog object including its type, version, and type-specific data. Required: id.
- **Square catalog objects upsert** (Upsert). Create or update a Square catalog object. Returns the upserted catalog_object including its id, type, and version. Requires idempotency_key and object.
- **Delete a Square catalog object by ID** (Delete). Delete a Square catalog object and all of its related/nested objects by id. Returns the list of deleted_object_ids. Required: id.
- **Square catalog objects search** (Search). Search Square catalog objects using complex filters. Returns matching catalog objects with their id, type, and version.
- **Square catalog objects search items** (Search). Search Square catalog items (ITEM and ITEM_VARIATION) by text, category, stock level, custom attributes, and more. Returns matching catalog items.
- **Square catalog objects batch upsert** (Upsert). Create or update up to 10,000 Square catalog objects in batches. Returns the upserted objects with id_mappings between client-supplied ids and server ids. Requires idempotency_key and batches.
- **Square catalog objects batch get** (Get). Retrieve a set of Square catalog objects by their ids. Returns the matching catalog objects and optionally any related objects. Requires object_ids.
- **Square catalog objects batch delete** (Delete). Delete a set of Square catalog objects by their ids in a single batch. Returns deleted_object_ids and a deleted_at timestamp. Requires object_ids.
- **Square catalog objects info** (Action). Get information about Square catalog API limits and configuration for the merchant account. Returns limits and standard_unit_description_group.
- **Square catalog objects update item modifier lists** (Update). Update the modifier lists enabled for one or more Square catalog items. Returns the updated_at timestamp. Requires item_ids.
- **Square catalog objects update item taxes** (Update). Update the taxes applied to one or more Square catalog items. Returns the updated_at timestamp. Requires item_ids.
- **Create a Square catalog image** (Create). Create a catalog image in Square and optionally attach it to an existing catalog object. Returns the created image object including its id and image_data (name, url, caption).
- **Update a Square catalog image by ID** (Update). Update an existing Square catalog image identified by id. Returns the updated image object including its id and image_data (name, url, caption). Required: id.
- **Get single Square inventory by ID** (Get). Get inventory counts for a Square catalog object across all locations. Returns: catalog_object_id, catalog_object_type, state, location_id, quantity, calculated_at. Required: id.
- **Square inventory batch get counts** (Get). Batch-retrieve Square inventory counts for the specified catalog objects and locations. Returns: catalog_object_id, catalog_object_type, state, location_id, quantity, calculated_at.
- **Square inventory batch get changes** (Get). Batch-retrieve Square inventory change history for the specified catalog objects and locations. Returns: type, physical_count, adjustment, transfer entries describing each inventory change.
- **Square inventory batch create changes** (Create). Batch-create Square inventory physical counts, adjustments, and transfers in a single call. Returns the applied changes including their generated ids and resulting inventory states. Requires idempotency_key and changes.
- **Square inventory get adjustment** (Get). Get a single Square inventory adjustment by id. Returns: id, reference_id, from_state, to_state, location_id, catalog_object_id, quantity, occurred_at. Required: adjustment_id.
- **Square inventory get physical count** (Get). Get a single Square inventory physical count by id. Returns: id, reference_id, catalog_object_id, state, location_id, quantity, occurred_at. Required: physical_count_id.
- **Square inventory get transfer** (Get). Get a single Square inventory transfer by id. Returns: id, reference_id, state, from_location_id, to_location_id, catalog_object_id, quantity, occurred_at. Required: transfer_id.
- **Square inventory changes** (Action). List inventory change history for a Square catalog object. Returns: type, physical_count, adjustment, transfer entries describing each inventory change. Required: catalog_object_id.
- **List all Square customers** (List). List customer profiles in Square. Returns an array of customer objects including id, given_name, family_name, email_address, phone_number, and created_at.
- **Get single Square customer by ID** (Get). Get a single Square customer profile by id. Returns the customer object including id, given_name, family_name, email_address, phone_number, address, and preferences. Required: id.
- **Create a Square customer** (Create). Create a new customer profile in Square. Returns the created customer object including id, created_at, and the profile fields supplied in the request.
- **Update a Square customer by ID** (Update). Update an existing Square customer profile by id. Returns the updated customer object including id, updated_at, and the modified profile fields. Required: id.
- **Delete a Square customer by ID** (Delete). Delete a Square customer profile by id. Returns an empty response on success. Required: id.
- **Square customers search** (Search). Search for Square customer profiles using filter and sort criteria. Returns an array of matching customer objects including id, given_name, family_name, email_address, and phone_number.
- **Square customers batch create** (Create). Create multiple Square customer profiles in a single request. Returns a map of responses keyed by request id, each containing the created customer object or any error encountered.
- **Square customers batch get** (Get). Retrieve multiple Square customer profiles in a single request. Returns a map of responses keyed by customer id, each containing the customer object or any error.
- **Square customers batch update** (Update). Update multiple Square customer profiles in a single request. Returns a map of responses keyed by customer id, each containing the updated customer object or any error.
- **Square customers batch delete** (Delete). Delete multiple Square customer profiles in a single request. Returns a map of responses keyed by customer id indicating success or any error encountered.
- **Square customers add group** (Add). Add a Square customer to a customer group. Returns an empty response on success. Required: customer_id and group_id.
- **Square customers remove group** (Delete). Remove a Square customer from a customer group. Returns an empty response on success. Required: customer_id and group_id.
- **Square customers create card** (Create). Add a card on file to a Square customer profile. Returns the created card object including id, card_brand, last_4, exp_month, exp_year, and cardholder_name. Required: customer_id and card_nonce.
- **Square customers delete card** (Delete). Remove a card on file from a Square customer profile. Returns an empty response on success. Required: customer_id and card_id.
- **List all Square customer groups** (List). List customer groups in Square. Returns the groups array with each group's id, name, and timestamps.
- **Get single Square customer group by ID** (Get). Get a Square customer group by id. Returns the group object including id, name, and timestamps. Required: id.
- **Create a Square customer group** (Create). Create a new customer group in Square. Returns the created group object including its id, name, and timestamps.
- **Update a Square customer group by ID** (Update). Update a Square customer group by id. Returns the updated group object. Required: id.
- **Delete a Square customer group by ID** (Delete). Delete a Square customer group by id. Returns an empty response on success. Required: id.
- **List all Square customer segments** (List). List customer segments defined in a Square seller account. Returns: id, name, created_at, updated_at.
- **Get single Square customer segment by ID** (Get). Get a single Square customer segment by id. Returns: id, name, created_at, updated_at. Required: id.
- **List all Square customer custom attribute definitions** (List). List customer custom attribute definitions in Square. Returns the collection of custom_attribute_definitions defined on the seller's customer profiles.
- **Get single Square customer custom attribute definition by ID** (Get). Get a Square customer custom attribute definition by id. Returns the custom_attribute_definition object. Required: id.
- **Create a Square customer custom attribute definition** (Create). Create a customer custom attribute definition in Square. Returns the created custom_attribute_definition.
- **Update a Square customer custom attribute definition by ID** (Update). Update a Square customer custom attribute definition by id. Returns the updated custom_attribute_definition. Required: id.
- **Delete a Square customer custom attribute definition by ID** (Delete). Delete a Square customer custom attribute definition by id. Required: id.
- **List all Square customer custom attributes** (List). List custom attributes assigned to a Square customer profile. Returns the customer's custom attribute values. Required: customer_id.
- **Get single Square customer custom attribute by ID** (Get). Get a single custom attribute assigned to a Square customer profile by id. Returns the custom attribute including its key and value. Required: customer_id, id.
- **Square customer custom attributes upsert** (Upsert). Create or update a custom attribute for a Square customer profile. Returns the resulting custom attribute. Required: customer_id, custom_attribute_key.
- **Delete a Square customer custom attribute by ID** (Delete). Delete a custom attribute from a Square customer profile. Returns an empty response on success. Required: customer_id, custom_attribute_key.
- **Square customer custom attributes bulk upsert** (Upsert). Create or update custom attributes for multiple Square customer profiles in a single request. Returns the resulting custom attribute values per customer.
- **List all Square cards** (List). List cards on file in Square. Returns card objects including id, card_brand, last_4, exp_month, exp_year, and cardholder_name.
- **Get single Square card by ID** (Get). Get a Square card on file by id. Returns the card object including id, card_brand, last_4, exp_month, exp_year, and cardholder_name. Required: id.
- **Create a Square card** (Create). Create a new card on file in Square. Returns the created card object including id, card_brand, last_4, exp_month, exp_year, and cardholder_name. Requires idempotency_key, source_id, and card.
- **Square cards disable** (Disable). Disable a Square card on file so it can no longer be used for payments. Returns the updated card object with enabled set to false. Required: card_id.
- **List all Square disputes** (List). List Square disputes for the authenticated merchant. Returns the disputes collection with each dispute's id, state, amount, and reason.
- **Get single Square dispute by ID** (Get). Get a single Square dispute by id. Returns the dispute object including its state, amount, reason, and related payment. Required: id.
- **Square disputes accept** (Accept). Accept a Square dispute, conceding the disputed amount to the cardholder. Returns the updated dispute object. Required: dispute_id.
- **Square disputes submit evidence** (Action). Submit all uploaded evidence for a Square dispute to the card network. Returns the updated dispute object. Required: dispute_id.
- **Square disputes create evidence text** (Create). Upload text evidence to a Square dispute. Returns the created evidence object including its id and evidence_type. Required: dispute_id.
- **Square disputes create evidence file** (Create). Upload a file evidence record to a Square dispute. Returns the created evidence object including its id. Required: dispute_id.
- **Square disputes list evidence** (List). List evidence attached to a Square dispute. Returns evidence records with their id and evidence_type. Required: dispute_id.
- **Square disputes get evidence** (Get). Get a single evidence record attached to a Square dispute. Returns the evidence object including its id and evidence_type. Required: dispute_id, evidence_id.
- **Square disputes delete evidence** (Delete). Delete an evidence record from a Square dispute. Required: dispute_id, evidence_id.
- **List all Square checkout payment links** (List). List Square checkout payment links. Returns the collection of payment_link objects.
- **Get single Square checkout payment link by ID** (Get). Get a Square checkout payment link by id. Returns the payment_link object. Required: id.
- **Create a Square checkout payment link** (Create). Create a Square checkout payment link. Returns the created payment_link object.
- **Update a Square checkout payment link by ID** (Update). Update a Square checkout payment link by id. Returns the updated payment_link object. Required: id.
- **Delete a Square checkout payment link by ID** (Delete). Delete a Square checkout payment link by id. Required: id.
- **Get single Square checkout location setting by ID** (Get). Get Square Online Checkout location settings for a specific location. Returns the location_settings object. Required: id.
- **Update a Square checkout location setting by ID** (Update). Update Square Online Checkout location settings for a specific location. Returns the updated location_settings object. Required: id.
- **Get single Square checkout merchant setting by ID** (Get). Get the Square online checkout merchant-level settings. Returns the merchant_settings object configured for the seller account.
- **Update a Square checkout merchant setting by ID** (Update). Update the Square online checkout merchant-level settings. Returns the updated merchant_settings object.
- **List all Square subscriptions** (List). Search Square subscriptions using filters and sort criteria. Returns a list of subscription objects including id, location_id, customer_id, plan_variation_id, status, and billing anchor details.
- **Get single Square subscription by ID** (Get). Get a Square subscription by id. Returns the subscription object including id, location_id, customer_id, plan_variation_id, status, start_date, and charged_through_date. Required: id.
- **Create a Square subscription** (Create). Create a new Square subscription that enrolls a customer in a subscription plan. Returns the created subscription object including id, status, and billing details. Required: idempotency_key, location_id, plan_variation_id, and customer_id.
- **Update a Square subscription by ID** (Update). Update an existing Square subscription identified by id. Returns the updated subscription object. Required: id and a subscription payload with the fields to change.
- **Square subscriptions cancel** (Cancel). Schedule cancellation of a Square subscription at the end of the current billing cycle. Returns the subscription with a scheduled cancel action. Required: subscription_id.
- **Square subscriptions pause** (Pause). Schedule a pause on a Square subscription. Returns the subscription including the newly created pause action. Required: subscription_id.
- **Square subscriptions resume** (Resume). Schedule resumption of a paused Square subscription. Returns the subscription including the newly created resume action. Required: subscription_id.
- **Square subscriptions swap plan** (Action). Schedule a plan-variation swap on a Square subscription. Returns the subscription including the newly created swap-plan action. Required: subscription_id and new_plan_variation_id.
- **Square subscriptions change billing anchor date** (Action). Change the billing anchor date of a Square subscription. Returns the subscription including the newly scheduled change action. Required: subscription_id.
- **Square subscriptions list events** (List). List events for a Square subscription in chronological order. Returns subscription event objects including id, subscription_event_type, effective_date, and plan_variation_id. Required: subscription_id.
- **Square subscriptions delete action** (Delete). Delete a scheduled action on a Square subscription. Returns the updated subscription with the action removed. Required: subscription_id and action_id.
- **List all Square invoices** (List). List Square invoices for a given location. Returns: id, version, location_id, primary_recipient, payment_requests, status, created_at, updated_at. Required: location_id.
- **Get single Square invoice by ID** (Get). Get a Square invoice by id. Returns the full invoice object including version, location_id, primary_recipient, payment_requests, status, and timestamps. Required: id.
- **Create a Square invoice** (Create). Create a draft Square invoice for an existing order. Returns the created invoice object including its id, version, status (DRAFT), and payment_requests. Requires invoice.
- **Update a Square invoice by ID** (Update). Update a draft Square invoice or a published invoice with a scheduled payment request. Returns the updated invoice object including its new version. Required: id, invoice.
- **Delete a Square invoice by ID** (Delete). Delete a Square invoice that is in DRAFT state. Returns an empty response on success. Required: id.
- **Square invoices search** (Search). Search Square invoices by location and optional customer filters. Returns: matching invoices with id, version, location_id, status, primary_recipient, and payment_requests. Requires query.filter.location_ids.
- **Square invoices publish** (Publish). Publish a Square invoice, transitioning it from DRAFT and triggering the configured delivery method. Returns the published invoice with updated status and version. Requires invoice_id, version, and idempotency_key.
- **Square invoices cancel** (Cancel). Cancel a Square invoice that is not in a terminal state (PAID, REFUNDED, CANCELED, or FAILED). Returns the canceled invoice with updated status and version. Requires invoice_id and version.
- **Square invoices create attachment** (Create). Upload an attachment to a Square invoice. Returns the created attachment including its id, filename, description, filesize, hash, mime_type, and uploaded_at. Required: invoice_id.
- **Square invoices delete attachment** (Delete). Remove an attachment from a Square invoice. Returns an empty response on success. Required: invoice_id and attachment_id.
- **List all Square merchants** (List). List Square merchants associated with the authenticated account. Returns merchant objects including id, business_name, country, language_code, currency, and status.
- **Get single Square merchant by ID** (Get). Get a single Square merchant by id. Returns the merchant object including id, business_name, country, language_code, currency, and status. Required: id.
- **List all Square merchant custom attribute definitions** (List). List custom attribute definitions for merchants in Square. Returns the collection of custom attribute definitions including their key, schema, name, description, and visibility.
- **Get single Square merchant custom attribute definition by ID** (Get). Get a merchant custom attribute definition in Square by id. Returns the definition including its key, schema, name, description, and visibility. Required: id.
- **Create a Square merchant custom attribute definition** (Create). Create a merchant custom attribute definition in Square. Returns the created definition including its key, schema, name, description, and visibility.
- **Update a Square merchant custom attribute definition by ID** (Update). Update a merchant custom attribute definition in Square by id. Returns the updated definition including its key, schema, name, description, and visibility. Required: id.
- **Delete a Square merchant custom attribute definition by ID** (Delete). Delete a merchant custom attribute definition in Square by id. Returns an empty response on success. Required: id.
- **List all Square merchant custom attributes** (List). List custom attributes for a Square merchant. Returns the merchant's custom_attributes array. Required: merchant_id.
- **Get single Square merchant custom attribute by ID** (Get). Get a single custom attribute for a Square merchant by id. Returns the custom_attribute object. Required: merchant_id, id.
- **Square merchant custom attributes upsert** (Upsert). Create or update a custom attribute on a Square merchant. Returns the upserted custom_attribute object. Required: merchant_id, custom_attribute_key.
- **Delete a Square merchant custom attribute by ID** (Delete). Delete a custom attribute from a Square merchant. Returns an empty response on success. Required: merchant_id, custom_attribute_key.
- **Square merchant custom attributes bulk upsert** (Upsert). Create or update multiple merchant custom attributes in Square in a single request. Returns the upserted values keyed by request identifier.
- **List all Square locations** (List). List all locations associated with a Square seller account. Returns location objects including id, name, address, timezone, status, and currency.
- **Get single Square location by ID** (Get). Get a single Square location by id. Returns the location object including name, address, timezone, business hours, status, and currency. Required: id.
- **Create a Square location** (Create). Create a new location for a Square seller. Returns the created location object including its id, name, address, and status.
- **Update a Square location by ID** (Update). Update an existing Square location by id. Returns the updated location object. Required: id.
- **List all Square location custom attribute definitions** (List). List Square location custom attribute definitions. Returns each definition with its key, schema, name, description, and visibility.
- **Get single Square location custom attribute definition by ID** (Get). Get a Square location custom attribute definition by id. Returns the definition including key, schema, name, description, and visibility. Required: id.
- **Create a Square location custom attribute definition** (Create). Create a Square location custom attribute definition. Returns the created definition with its key, schema, name, description, and visibility. Required: custom_attribute_definition.
- **Update a Square location custom attribute definition by ID** (Update). Update a Square location custom attribute definition by id. Returns the updated definition. Required: id and custom_attribute_definition.
- **Delete a Square location custom attribute definition by ID** (Delete). Delete a Square location custom attribute definition by id. Required: id. Deletes the definition and all associated values across locations.
- **List all Square location custom attributes** (List). List custom attributes for a Square location. Returns an array of custom_attribute objects including key, value, and visibility. Required: location_id.
- **Get single Square location custom attribute by ID** (Get). Get a single custom attribute for a Square location by id. Returns the custom_attribute object including its key, value, and visibility. Required: location_id, id.
- **Square location custom attributes upsert** (Upsert). Create or update a custom attribute on a Square location. Returns the upserted custom_attribute object. Required: location_id, custom_attribute_key.
- **Delete a Square location custom attribute by ID** (Delete). Delete a custom attribute from a Square location. Returns an empty response on success. Required: location_id, custom_attribute_key.
- **List all Square team members** (List). Search team members in Square with optional filters. Returns a list of team_member objects including id, reference_id, is_owner, status, given_name, family_name, email_address, phone_number, and assigned_locations.
- **Get single Square team member by ID** (Get). Get a Square team member by id. Returns the team_member object including id, reference_id, is_owner, status, given_name, family_name, email_address, phone_number, and assigned_locations. Required: id.
- **Create a Square team member** (Create). Create a team member in Square. Returns the created team_member object including its id, status, given_name, family_name, email_address, phone_number, and assigned_locations. Requires team_member.
- **Update a Square team member by ID** (Update). Update an existing team member in Square. Returns the updated team_member object including id, status, given_name, family_name, email_address, phone_number, and assigned_locations. Required: id and team_member.
- **Square team members batch create** (Create). Bulk create team members in Square. Returns a team_members map keyed by the provided idempotency keys, each entry containing the created team_member object and any errors. Requires team_members.
- **Square team members batch update** (Update). Bulk update team members in Square. Returns a team_members map keyed by team member id, each entry containing the updated team_member object and any errors. Requires team_members.
- **Get single Square wage setting by ID** (Get). Get the wage setting for a Square team member by id. Returns the wage_setting object with the team member's job assignments and pay rates. Required: id.
- **Update a Square wage setting by ID** (Update). Create or update the wage setting for a Square team member by id. Returns the updated wage_setting object. Required: id and a wage_setting payload.
- **List all Square jobs** (List). List jobs in a Square seller account, sorted by title in ascending order. Returns: jobs array (up to 100 per page) with job details.
- **Get single Square job by ID** (Get). Get a specified Square job by id. Returns the job object with its title and tip eligibility. Required: id.
- **Create a Square job** (Create). Create a job in a Square seller account, defining a title and tip eligibility. Returns the new job object. Required: job (with title) and idempotency_key.
- **Update a Square job by ID** (Update). Update the title or tip eligibility of a Square job. Changes to the title propagate to all JobAssignment, Shift, and TeamMemberWage objects referencing the job; tip eligibility changes propagate to TeamMemberWage objects. Returns the updated job. Required: id and job.
- **List all Square team member wages** (List). List team member wages in Square. Returns an array of team_member_wage objects.
- **Get single Square team member wage by ID** (Get). Get a single Square team member wage by id. Returns the team_member_wage object. Required: id.
- **List all Square break types** (List). List break types defined in Square Labor. Returns the collection of break_type objects including id, location_id, break_name, expected_duration, and is_paid.
- **Get single Square break type by ID** (Get). Get a single Square break type by id. Returns the break_type object including location_id, break_name, expected_duration, is_paid, and version. Requires id.
- **Create a Square break type** (Create). Create a new break type in Square Labor. Returns the created break_type including id, location_id, break_name, expected_duration, is_paid, and version. Requires break_type with location_id, break_name, expected_duration, and is_paid.
- **Update a Square break type by ID** (Update). Update an existing Square break type by id. Returns the updated break_type with its new break_name, expected_duration, is_paid, and version. Requires id and break_type.
- **Delete a Square break type by ID** (Delete). Delete a Square break type by id. Returns an empty response on success. Requires id.
- **List all Square shifts** (List). Search Square labor shifts using optional filters. Returns a list of shift objects including id, employee details, start/end times, breaks, and wage information.
- **Get single Square shift by ID** (Get). Get a single Square labor shift by id. Returns the shift object including employee, location, start/end times, breaks, and wage. Required: id.
- **Create a Square shift** (Create). Create a new Square labor shift. Returns the created shift object including id, team_member_id, location_id, start_at, end_at, and wage. Requires shift.
- **Update a Square shift by ID** (Update). Update an existing Square labor shift by id. Returns the updated shift object. Required: id, shift.
- **Delete a Square shift by ID** (Delete). Delete a Square labor shift by id. Required: id.
- **List all Square timecards** (List). Search Square labor timecards. Returns a list of timecard objects including id, employee/team member, clockin/clockout times, and version.
- **Get single Square timecard by ID** (Get). Get a single Square labor timecard by id. Returns the timecard object including its team member, clockin/clockout times, and version. Requires id.
- **Create a Square timecard** (Create). Create a new Square labor timecard. Returns the created timecard object including its id, team member, clockin/clockout times, and version.
- **Update a Square timecard by ID** (Update). Update an existing Square labor timecard by id. Returns the updated timecard object including its team member, clockin/clockout times, and version. Requires id.
- **Delete a Square timecard by ID** (Delete). Delete a Square labor timecard by id. Requires id.
- **List all Square workweek configs** (List). List workweek configurations in Square Labor. Returns workweek_configs with their schedule settings.
- **Update a Square workweek config by ID** (Update). Update a Square Labor workweek configuration by id. Returns the updated workweek_config. Required: id.
- **List all Square scheduled shifts** (List). Search Square scheduled shifts. Returns a list of scheduled_shifts matching the provided filters.
- **Get single Square scheduled shift by ID** (Get). Get a single Square scheduled shift by id. Returns the scheduled_shift object. Required: id.
- **Create a Square scheduled shift** (Create). Create a new scheduled shift in Square. Returns the created scheduled_shift object.
- **Update a Square scheduled shift by ID** (Update). Update an existing Square scheduled shift by id. Returns the updated scheduled_shift object. Required: id.
- **Square scheduled shifts publish** (Publish). Publish a Square scheduled shift, making it visible to the assigned team member. Returns the published scheduled_shift object. Required: scheduled_shift_id.
- **Square scheduled shifts bulk publish** (Publish). Publish multiple Square scheduled shifts in a single request. Returns the list of published scheduled_shifts.
- **List all Square bookings** (List). List bookings in Square. Returns an array of booking objects including id, status, start_at, location_id, customer_id, and appointment_segments.
- **Get single Square booking by ID** (Get). Get a Square booking by id. Returns the booking object including id, status, start_at, location_id, customer_id, and appointment_segments. Required: id.
- **Create a Square booking** (Create). Create a booking in Square. Returns the created booking including id, status, start_at, location_id, customer_id, and appointment_segments. Requires booking with start_at and appointment_segments.
- **Update a Square booking by ID** (Update). Update a Square booking by id. Returns the updated booking object. Required: id and booking.
- **Square bookings cancel** (Cancel). Cancel a Square booking. Returns the canceled booking with its updated status. Required: booking_id.
- **Square bookings search availability** (Search). Search availability for Square bookings within a time window and filters. Returns: availabilities with start_at, location_id, and appointment_segments. Requires query with a filter including start_at_range.
- **Square bookings get business profile** (Get). Get the Square seller's business booking profile. Returns: seller_id, created_at, booking_enabled, customer_timezone_choice, booking_policy, and allow_user_cancel.
- **Square bookings batch get** (Get). Bulk retrieve Square bookings by id. Returns a map of bookings keyed by id with their full booking objects. Requires booking_ids.
- **List all Square booking custom attribute definitions** (List). List Square booking custom attribute definitions. Returns the custom attribute definitions including their key, name, description, schema, and visibility.
- **Get single Square booking custom attribute definition by ID** (Get). Get a Square booking custom attribute definition by id. Returns the custom attribute definition including key, name, description, schema, and visibility. Required: id.
- **Create a Square booking custom attribute definition** (Create). Create a Square booking custom attribute definition. Returns the created custom attribute definition including its key, name, schema, and visibility. Requires custom_attribute_definition.
- **Update a Square booking custom attribute definition by ID** (Update). Update a Square booking custom attribute definition by id. Returns the updated custom attribute definition. Required: id, custom_attribute_definition.
- **Delete a Square booking custom attribute definition by ID** (Delete). Delete a Square booking custom attribute definition by id. Returns an empty response on success. Required: id.
- **List all Square booking custom attributes** (List). List custom attributes attached to a Square booking. Returns the booking's custom_attributes array. Required: booking_id.
- **Get single Square booking custom attribute by ID** (Get). Get a single custom attribute on a Square booking by key. Returns the custom_attribute object. Required: booking_id and id (the custom attribute key).
- **Square booking custom attributes upsert** (Upsert). Create or update a custom attribute on a Square booking. Returns the upserted custom_attribute object. Required: booking_id and custom_attribute_key.
- **Delete a Square booking custom attribute by ID** (Delete). Delete a custom attribute from a Square booking by key. Returns an empty response on success. Required: booking_id and custom_attribute_key.
- **List all Square team member booking profiles** (List). List team member booking profiles in Square. Returns the team_member_booking_profiles array with each profile's team member id, display name, description, and booking settings.
- **Get single Square team member booking profile by ID** (Get). Get a Square team member booking profile by id. Returns the team_member_booking_profile object including team_member_id, display_name, description, and is_bookable. Required: id.
- **Square team member booking profiles batch get** (Get). Retrieve multiple Square team member booking profiles in a single request. Returns the team_member_booking_profiles array for the requested team members. Required: team_member_ids.
- **List all Square location booking profiles** (List). List location booking profiles in Square. Returns the booking profile configuration for each seller location.
- **Get single Square location booking profile by ID** (Get). Get a Square location booking profile by id. Returns the booking profile for the specified location. Required: id.
- **List all Square loyalty programs** (List). List loyalty programs in Square. Returns the loyalty program objects configured for the seller, including id, status, reward tiers, and accrual rules.
- **Get single Square loyalty program by ID** (Get). Get a Square loyalty program by id. Returns the loyalty program object including its status, reward tiers, accrual rules, and terminology. Required: id.
- **Square loyalty programs calculate points** (Action). Calculate the points a buyer would earn for a purchase under a Square loyalty program. Returns the points that would be accrued. Required: program_id.
- **List all Square loyalty accounts** (List). Search Square loyalty accounts by mapping (such as a phone number) or customer ids. Returns: loyalty_accounts with id, program_id, balance, lifetime_points, customer_id, and mapping details.
- **Get single Square loyalty account by ID** (Get). Get a Square loyalty account by id. Returns the loyalty_account object including id, program_id, balance, lifetime_points, customer_id, enrolled_at, and mappings. Required: id.
- **Create a Square loyalty account** (Create). Create a Square loyalty account in a loyalty program. Returns the created loyalty_account with id, program_id, balance, lifetime_points, customer_id, and mapping. Requires loyalty_account (with program_id) and idempotency_key.
- **Square loyalty accounts accumulate points** (Action). Accumulate points on a Square loyalty account, either from an order or by manually specifying points. Returns the resulting event with id, type, loyalty_account_id, and points details. Required: account_id, accumulate_points, idempotency_key, and location_id.
- **Square loyalty accounts adjust points** (Action). Manually add or subtract points on a Square loyalty account. Returns the resulting event with id, type, loyalty_account_id, and adjustment details. Required: account_id, adjust_points (points and reason), and idempotency_key.
- **List all Square loyalty rewards** (List). Search Square loyalty rewards. Returns a list of reward objects including id, loyalty_account_id, reward_tier_id, points, order_id, status, and created_at.
- **Get single Square loyalty reward by ID** (Get). Get a Square loyalty reward by id. Returns the reward object including loyalty_account_id, reward_tier_id, points, order_id, status, created_at, and redeemed_at. Required: id.
- **Create a Square loyalty reward** (Create). Create a Square loyalty reward for a buyer's loyalty account, deducting the tier's points cost. Returns the created reward object including id, loyalty_account_id, reward_tier_id, points, status, and created_at. Requires reward and idempotency_key.
- **Delete a Square loyalty reward by ID** (Delete). Delete a Square loyalty reward by id, returning the deducted points back to the loyalty account. Required: id. Can only be used on rewards that have not been redeemed.
- **Square loyalty rewards redeem** (Action). Redeem a Square loyalty reward, marking it as REDEEMED so it cannot be reused. Returns the loyalty event recording the redemption including id, type, created_at, loyalty_account_id, and location_id. Required: reward_id, idempotency_key, location_id.
- **List all Square loyalty promotions** (List). List loyalty promotions for a Square loyalty program. Returns the loyalty_promotions array including each promotion's id, name, incentive, status, and availability. Required: program_id.
- **Get single Square loyalty promotion by ID** (Get). Get a single Square loyalty promotion by id. Returns the loyalty_promotion object including its id, name, incentive, status, and availability. Required: program_id and id.
- **Create a Square loyalty promotion** (Create). Create a new loyalty promotion under a Square loyalty program. Returns the created loyalty_promotion object including its id, status, and configuration. Required: program_id.
- **Square loyalty promotions cancel** (Cancel). Cancel an active Square loyalty promotion. Returns the updated loyalty_promotion object with its status set to CANCELED. Required: program_id and promotion_id.
- **List all Square loyalty events** (List). Search loyalty events in Square. Returns the list of loyalty events matching the provided filters.
- **List all Square gift cards** (List). List Square gift cards. Returns the gift_cards array with each card's id, gan, state, balance, and type.
- **Get single Square gift card by ID** (Get). Get a Square gift card by id. Returns the gift_card object including id, gan, state, balance_money, and type. Required: id.
- **Create a Square gift card** (Create). Create a new Square gift card. Returns the created gift_card object including id, gan, state, balance_money, and type. Requires idempotency_key, location_id, and gift_card.
- **Square gift cards get from gan** (Get). Retrieve a Square gift card using its gift account number (GAN). Returns the gift_card object including id, gan, state, balance_money, and type. Requires gan.
- **Square gift cards get from nonce** (Get). Retrieve a Square gift card using a payment token (nonce). Returns the gift_card object including id, gan, state, balance_money, and type. Requires nonce.
- **Square gift cards link customer** (Action). Link a Square customer to a gift card. Returns the updated gift_card object with the customer linked. Required: gift_card_id and customer_id.
- **Square gift cards unlink customer** (Action). Unlink a Square customer from a gift card. Returns the updated gift_card object with the customer removed. Required: gift_card_id and customer_id.
- **List all Square gift card activities** (List). List gift card activities in Square. Returns an array of gift card activity objects.
- **Create a Square gift card activity** (Create). Create a gift card activity in Square (e.g., to load, activate, or redeem a gift card). Returns the created gift_card_activity object.
- **List all Square terminal checkouts** (List). Search Square Terminal checkouts by filter and sort criteria. Returns a list of checkout objects including id, amount_money, device_options, status, and created_at.
- **Get single Square terminal checkout by ID** (Get). Get a Square Terminal checkout by id. Returns the checkout object including id, amount_money, device_options, status, reference_id, and created_at. Required: id.
- **Create a Square terminal checkout** (Create). Create a Square Terminal checkout and send it to the specified device for processing. Returns the created checkout including id, amount_money, device_options, status, and created_at. Requires idempotency_key and checkout.
- **Square terminal checkouts cancel** (Cancel). Cancel a Square Terminal checkout that is in progress. Returns the updated checkout object with status set to CANCELED. Required: checkout_id.
- **Square terminal checkouts dismiss** (Action). Dismiss a Square Terminal checkout request from the device screen if it has not yet been accepted. Returns the dismissed checkout object. Required: checkout_id.
- **List all Square terminal actions** (List). Search Square Terminal actions by filter and sort criteria. Returns matching terminal action objects.
- **Get single Square terminal action by ID** (Get). Get a Square Terminal action by id. Returns the terminal action object including its id, status, type, deadline_duration, and associated device or payment details. Required: id.
- **Create a Square terminal action** (Create). Create a Square Terminal action to send to a paired terminal device. Returns the created terminal action including its id, status, and type. Required: idempotency_key and action.
- **Square terminal actions cancel** (Cancel). Cancel a pending Square Terminal action. Returns the canceled terminal action object with its updated status. Required: action_id.
- **Square terminal actions dismiss** (Action). Dismiss a Square Terminal action that is currently displayed on the device. Returns the dismissed terminal action object with its updated status. Required: action_id.
- **List all Square terminal refunds** (List). Search Square Terminal refunds. Returns matching refund objects including id, status, amount_money, payment_id, reason, device_id, and timestamps.
- **Get single Square terminal refund by ID** (Get). Get a Square Terminal refund by id. Returns the refund object including status, amount_money, payment_id, reason, device_id, and timestamps. Requires id.
- **Create a Square terminal refund** (Create). Create a Square Terminal refund request and send it to the paired device. Returns the created refund including id, status, amount_money, payment_id, and device_id. Requires idempotency_key and refund (payment_id, amount_money, reason, device_id).
- **Square terminal refunds cancel** (Cancel). Cancel a Square Terminal refund request that has not yet been completed. Returns the updated refund object with its new status. Requires refund_id.
- **Square terminal refunds dismiss** (Action). Dismiss a Square Terminal refund request that has not been acted on by the device. Returns the updated refund object with its new status. Requires refund_id.
- **List all Square devices** (List). List devices associated with a Square account. Returns an array of device objects including their id and attributes.
- **Get single Square device by ID** (Get). Get a single Square device by id. Returns the device object including its id and attributes. Required: id.
- **List all Square device codes** (List). List Square device codes. Returns the device_codes array with each code's id, code, name, product_type, location_id, status, and timestamps.
- **Get single Square device code by ID** (Get). Get a single Square device code by id. Returns the device_code object including code, name, product_type, location_id, status, and pair_by/created_at timestamps. Required: id.
- **Create a Square device code** (Create). Create a Square device code used to pair a device (such as a Square Terminal) to a location. Returns the created device_code including its id, code, status, and pair_by timestamp. Requires idempotency_key and device_code (with product_type).
- **List all Square cash drawer shifts** (List). List cash drawer shifts for a Square location. Returns summary cash drawer shift objects including id, state, opened_at, closed_at, and opening/closing amounts. Required: location_id.
- **Get single Square cash drawer shift by ID** (Get). Get a Square cash drawer shift by id. Returns the full cash_drawer_shift including state, opened_at, closed_at, opening/closing/cash sales/cash refunds amounts, and related employee ids. Required: id and location_id.
- **Square cash drawer shifts list events** (List). List events for a Square cash drawer shift. Returns cash drawer shift events including id, event_type, event_money, created_at, and description. Required: shift_id and location_id.
- **List all Square bank accounts** (List). List bank accounts linked to a Square account. Returns an array of bank account objects including id, account_number_suffix, country, currency, account_type, holder_name, and status.
- **Get single Square bank account by ID** (Get). Get a Square bank account by id. Returns the bank account object including id, account_number_suffix, country, currency, account_type, holder_name, and status. Required: id.
- **Square bank accounts get by v 1 ID** (Get). Get a Square bank account by its v1 identifier. Returns the bank account object including id, account_number_suffix, country, currency, account_type, holder_name, and status. Required: v1_bank_account_id.
- **List all Square payouts** (List). List Square payouts. Returns an array of payout objects including id, status, amount_money, destination, and created_at.
- **Get single Square payout by ID** (Get). Get a Square payout by id. Returns the payout object including id, status, amount_money, destination, and created_at. Required: id.
- **Square payouts list entries** (List). List entries for a Square payout. Returns payout entry objects including id, payout_id, effective_at, type, and gross_amount_money. Required: payout_id.
- **List all Square vendors** (List). Search vendors in Square. Returns a list of vendor objects matching the supplied filter and sort criteria.
- **Get single Square vendor by ID** (Get). Get a Square vendor by id. Returns the vendor object including its name, contacts, address, and status. Required: id.
- **Create a Square vendor** (Create). Create a vendor in Square. Returns the created vendor object including its id, name, and status. Requires a vendor payload and an idempotency_key.
- **Update a Square vendor by ID** (Update). Update an existing Square vendor by id. Returns the updated vendor object. Required: id and a vendor payload including its current version for optimistic concurrency.
- **Square vendors batch create** (Create). Create multiple vendors in Square in a single request. Returns a list of responses, one per vendor created. Required: vendors map keyed by idempotency key.
- **Square vendors batch get** (Get). Retrieve multiple Square vendors by id in a single request. Returns a list of responses, one per requested vendor. Required: vendor_ids.
- **Square vendors batch update** (Update). Update multiple Square vendors in a single request. Returns a list of responses, one per updated vendor. Required: vendors map keyed by vendor id, each entry including the vendor's current version.
- **List all Square sites** (List). List Square Online sites associated with the seller account. Returns the sites array including each site's id, site_title, domain, and status.
- **Get single Square snippet by ID** (Get). Get the snippet associated with a Square site. Returns the snippet object for the specified site. Required: site_id.
- **Square snippets upsert** (Upsert). Add or update the snippet for a Square site. Returns the upserted snippet object. Required: site_id.
- **Delete a Square snippet by ID** (Delete). Delete the snippet from a Square site. Required: site_id.
- **Square events search** (Search). Search Square events. Returns a list of event objects with their associated metadata.
- **Square events list types** (List). List the event types that Square publishes. Returns: event_types as an array of supported event type identifiers.
- **Square events enable** (Enable). Enable events publishing for the Square account.
- **Square events disable** (Disable). Disable events publishing for the Square account.
- **List all Square webhook subscriptions** (List). List webhook subscriptions in Square. Returns: subscription objects including id, name, enabled, event_types, notification_url, and api_version.
- **Get single Square webhook subscription by ID** (Get). Get a single Square webhook subscription by id. Returns the subscription object including name, enabled, event_types, notification_url, api_version, and signature_key. Requires id.
- **Create a Square webhook subscription** (Create). Create a webhook subscription in Square. Returns the created subscription including its id, name, event_types, notification_url, and signature_key. Requires subscription with name, event_types, and notification_url.
- **Update a Square webhook subscription by ID** (Update). Update a Square webhook subscription by id. Returns the updated subscription including name, event_types, notification_url, and enabled. Requires id and the subscription object with fields to update.
- **Delete a Square webhook subscription by ID** (Delete). Delete a Square webhook subscription by id. Returns an empty response on success. Requires id.
- **Square webhook subscriptions test** (Test). Send a test event to a Square webhook subscription's notification URL. Returns: subscription_test_result with id, status_code, payload, and created_at. Requires subscription_id.
- **Square webhook subscriptions list event types** (List). List the event types that webhook subscriptions can listen to in Square. Returns: event_types with their names and metadata.
- **List all Square employees** (List). List employees in Square. Returns an array of employee objects.
- **Get single Square employee by ID** (Get). Get a Square employee by id. Returns the employee object. Required: id.
