Square Toolkit

Superglue tools for Square: payments, refunds, orders, catalog items, inventory adjustments, and customers.

Quick Setup

1

Get your tool config

Use the Download Config or Copy Config buttons in the table below (placeholders for now). Paste or save this JSON in your project.

2

Set up authentication

We use API keys, not OAuth, for this integration. Create an access token in your Square Developer Dashboard > Applications > API Keys. Add SQUARE_ACCESS_TOKEN and optionally SQUARE_ENVIRONMENT (sandbox/production) to your environment variables. Set Authorization: Bearer ${SQUARE_ACCESS_TOKEN} header. See official docs: Square API Access Tokens

3

Install the superglue SDK

npm install @superglue/client

4

Run locally

The SDK executes the JSON workflow locally using your environment credentials. No API key required.

Drop-In Code Example

The SDK executes the downloaded JSON workflow locally using your environment's Square access token.

TypeScript 
import { SuperglueClient } from "@superglue/client";
import config from "./square_list_payments.json"; // or paste JSON string

const client = new SuperglueClient();

async function run() {
  const result = await client.run(config, {
    env: {
      SQUARE_ACCESS_TOKEN: process.env.SQUARE_ACCESS_TOKEN!,
      SQUARE_ENVIRONMENT: process.env.SQUARE_ENVIRONMENT || "sandbox",
      SUPERGLUE_REDIRECT_URI: process.env.SUPERGLUE_REDIRECT_URI || "https://app.superglue.cloud/api/auth/callback"
    }
  });
  console.log(JSON.stringify(result, null, 2));
}
run();

Tools in Toolkit

ToolActions

square_list_payments

List payments for a time window and location.

👥 1,180 users

square_refund_payment

Create a refund for a completed payment.

👥 1,120 users

square_search_orders

Search orders for one or more locations.

👥 1,065 users

square_list_catalog_items

List catalog items and variations with prices.

👥 1,022 users

square_adjust_inventory

Apply inventory adjustments for catalog items.

👥 984 users

square_create_customer

Create a customer profile.

👥 951 users