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: July 2026HR & Payroll
API GRADE
C
VERIFIED JUL 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.
Supergood: Square Payroll has an API, with gaps. We cover what it's missing: stable endpoints, normalized JSON, managed auth.

Frequently asked questions

Square Payroll scores C on the 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