Squareup connector icon

Squareup Connector

Embed in-app Squareup integrations to accept payments, sync customer profiles, manage orders and invoices, and trigger workflows from POS events — all delivered inside your SaaS product using Cyclr’s visual integration builder.

Build with this Connector Talk to an integration expert
01

Accept payments in-app

Create payments, refunds and fee routing via Square Payments API.

02

Customer data sync

Synchronize Customer records and locations between systems.

03

Event driven workflows

Use Square webhooks to trigger real-time Cycles and automations.

04

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

What teams can integrate or automate with Squareup

Integrate payments, customers, orders, invoices, catalog items and location data to automate billing and POS workflows. Use Square’s Payments, Customers, Orders and Invoices APIs to create payments, refunds, customer records and sync item catalogs. Learn more in the Square API documentation. (developer.squareup.com)

PRODUCT USE CASES

Top Use Cases for Squareup Integrations

Build customer-facing automations that accept and reconcile payments, sync customer records, update catalogs and trigger actions from Square webhooks — delivered through a white-label embedded marketplace or API-driven MCP runtime. (developer.squareup.com)

In-app checkout and reconciliation

Create Payment objects and record refunds using the Payments API; reconcile with your billing ledger. (developer.squareup.com)

Customer profiles and locations sync

Create and update Customer records and Location data to keep user profiles synchronized. (developer.squareup.com)

Trigger workflows from POS events

Subscribe to payment and order webhooks to start Cycles that notify systems or update orders. (developer.squareup.com)

ORCHESTRATION

How Squareup works with Cyclr

Cyclr sits between your SaaS product and Squareup to handle authentication, govern access and orchestrate every API call per customer, at scale.

  1. 1

    Your SaaS product

    Your app requests an action for a specific customer.

  2. 2

    Cyclr orchestration

    Cyclr authenticates, applies policies and routes the request.

  3. 3

    Squareup

    Squareup processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore Squareup methods you can orchestrate through Cyclr.

Gift Cards2

List New Gift Cards

Action

Retrieves a collection of gift cards created since last cycle run.

List Gift Cards

Action

Retrieves a collection of gift cards.

Orders8

List Updated Orders

Action

Retrieves a collection of existing orders updated since the last cycle run.

Search Orders

Action

Retrieves a collection of orders.

Get Order

Action

Retrieves an order by ID.

List Orders By Date Range

Action

Get a list of all orders for a location from the specified date range.

List Completed Orders By Location

Action

Gets a list of orders by location that have been completed within a date range.

List New Orders

Action

Retrieves a collection of orders created since the last cycle run.

List Orders By Location

Action

Get a list of all orders for a location or all orders of a given customer.

List New Orders By Location

Action

Get a list of all orders for a location after the last run time.

Vendors3

List Updated Vendors

Action

Retrieve a collection of existing vendors updated since last cycle run.

List New Vendors

Action

Retrieve a collection of vendors created since last cycle run.

Search Vendors

Action

Retrieve a collection of vendors.

Disputes3

List Updated Disputes

Action

Retrieves a collection of existing disputes updated since last cycle.

List Disputes

Action

Retrieves a collection of disputes.

List New Disputes

Action

Retrieves a collection of disputes created since last cycle.

Refunds4

Get Refund

Action

Retrieves details for a specific refund.

List New Refunds

Action

Retrieves a list of refunds, made by the account making the request, created since the last cycle run.

List Updated Refunds

Action

Retrieves a list of existing refunds, made by the account making the request, updated since the last cycle run.

List Refunds

Action

Retrieves a list of refunds made by the account making the request.

Inventory2

List Updated Inventory Counts

Action

Retrieve a collection of existing inventory counts updated since last cycle run.

Search Inventory Counts

Action

Retrieve a collection of inventory counts.

Labor2

List Workweek Configs

Action

Returns a list of Workweek Configurations for a business.

List Break Types

Action

Returns a list of break types fo a business.

Catalog6

List Catalog

Action

Retrieve a list of all catalogs.

Search Catalog Items

Action

Retrieve a list of catalog items by the given ID.

Search Item Catalog Objects

Action

Search catalog objects with the type of 'ITEM'.

Upsert Catalog Object

Action

Updates the specified Catalog Object.

Get Catalog Object

Action

Retrieve Catalog Object by the given ID.

Delete Catalog Object

Action

Deletes a single Catalog Object by the given ID.

Subscriptions2

Search Subscriptions

Action

Retrieves a collection of subscriptions.

List New Subscriptions

Action

Retrieves a collection of subscriptions created since last cycle run.

Authentication Tokens1

Get Token Status

Action

Retrieve details on the status of an access token.

Invoices3

List New Invoices by Location

Action

Retrieve a collection of a locations invoices created since last cycle run.

List Invoices by Location

Action

Retrieve a collection of a locations invoices.

List New & Updated Invoices by Location (Incrementally)

Action

Retrieve a collection of a existing locations invoices updated since last cycle run incrementally.

Locations2

List New Locations

Action

Get a list of all locations created since last cycle run.

List Locations

Action

Get a list of all locations.

Team Members4

Get Team Member

Action

Gets a team member by their team member ID.

List New Team Members

Action

List all team members created since the last successful cycle run.

List Team Members

Action

List all team members.

List Updated Team Members

Action

List all team members updated since the last successful cycle run.

Payments4

Get Payment

Action

Retrieves details for a specific payment.

List Updated Payments

Action

Retrieves a list of existing payments updated since the last cycle run.

List New Payments

Action

Retrieves a list of payments created since the last cycle run.

List Payments

Action

Retrieves a list of payments taken by the account making the request.

Customers20

Create Customer

Action

Create a new customer.

Update Customer

Action

Update an existing Customer by ID.

List New And Updated Customers

Action

Get a List of all Customers who were added or updated after the last run time.

Get Customer

Action

Retrieve a single customer by their ID.

List New And Updated Customers (Incrementally)

Action

Get a List of all Customers who were added or updated after the last run time Incrementally.

Search Customers

Action

Searches the customer profiles associated with a Square account using one or more supported query filters.

Delete Customer

Action

Delete an existing Customer by ID.

List Customers

Action

Get a list of all customers.

List Updated Customer Groups

Action

Retrieves a collection of existing customer groups updated since last cycle run.

List Customer Groups

Action

Retrieves a collection of customer groups.

List New Customer Groups

Action

Retrieves a collection of customer groups created since last cycle run.

List New Custom Attributes By Customer ID

Action

Retrieves a collection of custom attributes, created since the last cycle run. These are filtered by customer ID.

List New Customer Custom Attribute Definitions

Action

Retrieves a collection of customer custom attribute definitions, created since the last cycle run.

List Custom Attributes By Customer ID

Action

Retrieves a collection of existing custom attributes. These are filtered by customer ID.

List Updated Customer Custom Attribute Definitions

Action

Retrieves a collection of existing customer custom attribute definitions, updated since the last cycle run.

List Updated Custom Attributes By Customer ID

Action

Retrieves a collection of existing custom attributes, updated since the last cycle run. These are filtered by customer ID.

List Customer Custom Attribute Definitions

Action

Retrieves a collection of customer custom attribute definitions.

List Customer Segments

Action

Retrieves a collection of customer segments.

List Updated Customer Segments

Action

Retrieves a collection of existing customer segments updated since last cycle.

List New Customer Segments

Action

Retrieves a collection of customer segments created since last cycle.

Checkouts3

List Updated Payment Links

Action

Retrieves a collection of existing checkout payment links, updated since the last cycle run.

List New Payment Links

Action

Retrieves a collection of new checkout payment links, created since the last cycle run.

List Payment Links

Action

Retrieves a collection of checkout payment links.

TECHNICAL DETAILS

Squareup integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing Squareup integrations in Cyclr.

API and authentication

API host
https://connect.squareup.com
Authentication
OAuth 2.0; Access token
Credentials

Client ID; Client Secret; Production or Sandbox Access Token (API Key).

Method categories

Payments; Customers; Orders; Invoices; Catalog; Subscriptions; Webhooks; Locations

View vendor API documentation →

Pagination and rate limits

Pagination

Cursor-based pagination using limit and cursor parameters; include returned cursor to fetch the next page. (developer.squareup.com)

Rate limits

Rate limits vary by endpoint; APIs may return 429 — implement retries and backoff. (developer.squareup.com)

IMPLEMENTATION

Authentication at a glance

Cyclr supports Square OAuth for multi-seller installations and Square personal Access Tokens for single-account installs; supply Application ID/Secret for OAuth or paste a Production/Sandbox Access Token. (community.cyclr.com)

Authentication method
OAuth 2.0; Access token
Credential required

Client ID; Client Secret; Production or Sandbox Access Token (API Key).

Before you begin:

Sandbox and Production use separate credentials; choose OAuth for multi-seller platforms. (community.cyclr.com)

View setup guide

COMMON QUESTIONS

Frequently asked questions

It integrates payments, customer profiles, orders, invoices, catalog items and locations so you can accept payments, create refunds, sync customers and automate order workflows. (developer.squareup.com)

Use OAuth 2.0 to onboard many sellers or paste a Production/Sandbox Access Token for single-account installs; Cyclr’s setup page accepts Client ID/Secret or API Key. (community.cyclr.com)

Yes. Use Square OAuth for multi-merchant installs and Cyclr’s embedded marketplace to publish per-account installations and credentials. (community.cyclr.com)

Yes. Cyclr can wrap connector methods and workflows as governed MCP capabilities for reuse, monitoring and tenant-level governance. (cyclr.com)

KEEP EXPLORING

Related resources and connectors

Documentation

What is iPaaS?

Read more →Product

How to develop an API – Best Practices to Follow from Cyclr Developers

Read more →Product

MCP PaaS

Read more →Related connector

Heartland

Related Billing/Payment connector for customer-facing integration workflows.

Related connector

Lightspeed Retail (X-Series)

Related Billing/Payment connector for customer-facing integration workflows.

Related connector

PayTrace

Related Billing/Payment connector for customer-facing integration workflows.

Let Cyclr handle the integrations.

You focus on building the product your customers love.

Start building for free Get a demo