Connect Square Appointments

Square OAuth setup. Once VoxReach admin sets the Square OAuth client_id + secret, tenants click 'Connect via OAuth' — 30 seconds, no token paste.

Provider docs

Step 1 — VoxReach admin: register a Square OAuth app (one-time, platform-wide)

Sign in at developer.squareup.com → My Applications → New Application.
Name it 'VoxReach AI'. Production environment.
Set OAuth redirect URI: https://app.voxreach.com.au/integrations/square_appointments/oauth/callback
Required scopes: APPOINTMENTS_ALL_READ, APPOINTMENTS_ALL_WRITE, APPOINTMENTS_READ, APPOINTMENTS_WRITE, CUSTOMERS_READ, CUSTOMERS_WRITE, EMPLOYEES_READ, MERCHANT_PROFILE_READ, ITEMS_READ.
Copy the Application ID and Application Secret from the OAuth tab.
In VoxReach Admin → Secrets, add: SQUARE_CLIENT_ID = , SQUARE_CLIENT_SECRET = .

Tenant goes to Integrations → Square Appointments → Connect via OAuth.
Redirected to Square's authorisation screen.
Tenant clicks 'Allow' to grant the listed scopes.
Square redirects back to VoxReach with a code; we exchange it for an access_token + refresh_token automatically.
Tools attach to all AI agents within seconds.

Set as default booking provider, configure SMS confirmation + staff notification, set default duration matching your typical service length.
Square Appointments stores customer phone numbers — make sure your customers have a phone number on their Square Customer record so the AI can match incoming calls.

OAuth not configured — VoxReach admin hasn't set SQUARE_CLIENT_ID/SECRET in /admin/secrets yet.
Tenant sees 401 mid-call — token expired and refresh failed. Check /api/cron/oauth-refresh logs in admin/audit.
No location found — multi-location merchants: AI uses the first location in your account. To pin to a specific location, set 'location_id' in the integration config (advanced).