The API Report CardAPI Index
Square Payroll

Square Payroll API

Enterprise HR / ERP · squareup.com

Square's developer platform is self-serve REST and GraphQL with OAuth 2.0 and a free sandbox, and the Labor and Team APIs carry most payroll data. The dedicated Payroll API is the exception: it is gated behind Square sales and not generally available to developer accounts.

Last verified: August 2026HR & PayrollMCP PARTIAL
API GRADE
C
VERIFIED AUG 2026

SCORECARD

ExistenceGOODREST and GraphQL APIs on developer.squareup.com; the Labor and Team APIs expose the payroll data surface.
AccessPOORThe Payroll API is not on the self-serve developer surface; access goes through Square sales, unlike the rest of the platform.
CoverageMIXEDTimecards, shifts, and wages flow through Labor and Team APIs; payroll runs sit behind the gated Payroll API.
AuthMIXEDOAuth 2.0 with merchant-granted scopes; per-merchant authorization adds onboarding friction for multi-tenant apps.
Docs & DXMIXEDSDKs in seven languages and a free sandbox, but the gated Payroll endpoints are not on the public portal.
StabilityMIXEDThe Labor API Shift to Timecard migration created duplicate-event scenarios partners handle defensively.
MCPPARTIALSquare's official MCP server covers the broader Square API platform, including labor and team management, but Square Payroll itself has no public API and no payroll objects are exposed through the server. Payroll-specific MCP access is missing. VERIFIED 2026-08
Supergood turns hard-to-integrate enterprise software into clean REST APIs and MCP tools: stable endpoints, normalized JSON, managed auth.

Frequently asked questions

Square Payroll scores C on Supergood's API Report Card. Square's developer platform is self-serve REST and GraphQL with OAuth 2.0 and a free sandbox, and the Labor and Team APIs carry most payroll data. The dedicated Payroll API is the exception: it is gated behind Square sales and not generally available to developer accounts.

Tried to integrate with Square Payroll?
SOURCES
Square Payroll API is not automatically available to all developer accounts - access requires contacting Square sales / developer support, blocking self-serve integration apitracker.io
Most third-party 'Square Payroll integrations' actually integrate via Labor API + Team API + screen-scraping or via unified-API vendors (Finch, Merge), not via a clean first-party Payroll API merge.dev
Unified-API platforms (Finch, Merge) have built dedicated Square Payroll connectors specifically because direct integration is non-trivial - classic 'why this exists' signal tryfinch.com
Documentation for the gated Payroll endpoints is not part of the public developer portal, making pre-sale technical evaluation difficult rollout.com
Labor API / Shift-vs-Timecard migration has caused duplicate-event scenarios that integration partners must handle defensively developer.squareup.com
Square's strict OAuth scope model and merchant-by-merchant authorization adds per-customer onboarding friction for multi-tenant SaaS vendors developer.squareup.com
Rate limits and quotas are documented at a high level but can throttle bulk historical-data sync for new integrations developer.squareup.com
Square can revoke OAuth tokens / disable merchant access unilaterally (account holds), breaking downstream integrations without warning bbb.org
GraphQL coverage is partial - many endpoints remain REST-only, forcing mixed-style integrations developer.squareup.com
Sandbox does not fully simulate Payroll/Labor tax-filing behavior - production validation requires a live merchant account developer.squareup.com
Customer support is widely cited as Square Payroll's weakest dimension - long hold times, reps without payroll-specific knowledge, repeated transfers humanresource.com
Reports of mishandled payroll taxes and YTD wage discrepancies on employee paystubs requiring manual reconciliation community.squareup.com
Account holds / abrupt service termination - Square can disable or restrict payroll/Checking with funds held up to 90 days, with limited recourse bbb.org
Limited support for 501(c)(3) nonprofit payroll-tax exemptions; PTO accrual reporting bugs surfaced by users trustradius.com
Multi-month setup/onboarding stalls reported by some new customers, especially those migrating from another provider softwareadvice.com
Switching bank accounts can trigger holds and loss of 2-day payroll processing privileges with little warning community.squareup.com
Thin HR / benefits administration compared to Gusto, Rippling, ADP - benefits, 401(k), workers' comp are partner-bolt-ons rather than native merchantmaverick.com
Square Inc. carries a 1.08/5 average customer-review rating at the BBB across 499 reviews (parent-company-wide, but payroll complaints contribute) bbb.org