Square Integration

FrontdeQ integrates with Square to read your business data and create bookings on behalf of callers. This page explains what the integration does and what permissions it needs.

Connecting Square

During setup, you'll be asked to connect your Square account via OAuth. This is the standard Square authorization flow. FrontdeQ requests these permissions:

• Read your catalog (services, prices, durations)
• Read your team (stylists, their schedules, booking profiles)
• Read and write bookings (check availability, create and update appointments)
• Read customers (look up callers by phone number or email)
• Create customers (register new callers who don't exist in Square yet)

Your Square credentials are encrypted at rest and never shared.

What the AI Reads

On every inbound call, the AI may query:

Booking Flow

1. Caller requests a service and time
2. AI calls searchAvailability with the service, stylist, and date range
3. AI presents available slots to the caller
4. Caller confirms
5. AI calls createBooking with the selected slot, service, stylist, and customer ID
6. Booking appears in your Square calendar immediately

Rescheduling

1. AI looks up the caller's existing bookings via listBookings
2. Caller specifies the new time
3. AI checks availability for the new slot
4. AI calls updateBooking with the new start time
5. Square calendar updates instantly

Security

• OAuth tokens are encrypted with AES-256 before storage
• Tokens are automatically refreshed when they expire
• Each organization has isolated credentials (multi-tenant)
• You can revoke access anytime from your Square Developer Dashboard