Acuity Scheduling API - Appointments & Booking Data

"Appointment & Booking Management" by John Rippy | johnrippy.link

🏆 2025 Zapier Automation Hero of the Year — Project Phoenix: A 95-step AI sales pipeline cutting development time by 50%. Read more →

---

Access Acuity Scheduling (Squarespace Scheduling) data for appointments, clients, calendars, availability, packages, and booking management. Perfect for consultants, coaches, therapists, salons, and service businesses.

Features

• Appointments: Upcoming, past, and canceled appointments
• Clients: Client database with contact info and history
• Calendars: Staff calendars and availability
• Appointment Types: Service offerings and pricing
• Packages: Prepaid packages and bundles
• Availability: Real-time availability slots
• Forms: Intake forms and custom fields
• Certificates: Gift certificates and credits
• Demo Mode: Test with realistic sample data

Use Cases

Consultants & Coaches

• Export client contact lists for marketing
• Analyze appointment trends and busy times
• Track package usage and revenue
• Generate client reports

Salons & Spas

• Monitor stylist/therapist bookings
• Track no-shows and cancellations
• Analyze service popularity
• Export client data for promotions

Healthcare Providers

• Patient appointment history
• Availability management
• Intake form responses
• Compliance reporting

Business Analytics

• Revenue forecasting
• Capacity utilization
• Client retention analysis
• Marketing campaign tracking

Input Parameters

Task Selection

• task: Operation to perform
  • get_appointments - List appointments
  • get_appointment_details - Get specific appointment
  • get_clients - List clients
  • get_client_details - Get client details
  • get_calendars - List calendars/staff
  • get_availability - Get available time slots
  • get_appointment_types - List service types
  • get_packages - List packages
  • get_products - List products
  • get_coupons - List discount coupons
  • get_forms - List intake forms
  • get_certificates - List gift certificates
  • get_blocks - List blocked time

Authentication

• userId: Acuity User ID
• apiKey: Acuity API Key
• demoMode: Run with sample data

Filters

• appointmentId: Specific appointment
• clientId: Filter by client
• calendarId: Filter by calendar/staff
• appointmentTypeId: Filter by service type
• startDate / endDate: Date range
• email: Filter by client email
• canceled: Include canceled appointments
• month: Month for availability

Example Output

Appointments

{
  "task": "get_appointments",
  "success": true,
  "data": {
    "appointments": [
      {
        "id": 123456789,
        "type": "Consultation Call",
        "datetime": "2024-01-22T10:00:00-0800",
        "endTime": "2024-01-22T11:00:00-0800",
        "duration": 60,
        "client": {
          "id": 98765,
          "firstName": "Jennifer",
          "lastName": "Smith",
          "email": "jennifer@email.com",
          "phone": "555-123-4567"
        },
        "calendar": {
          "id": 1,
          "name": "Sarah Johnson"
        },
        "price": 150.00,
        "paid": true,
        "confirmationPage": "https://acuity.com/...",
        "location": "Zoom",
        "notes": "Discuss Q1 strategy",
        "canceled": false
      }
    ],
    "totalCount": 45
  }
}

Clients

{
  "task": "get_clients",
  "success": true,
  "data": {
    "clients": [
      {
        "id": 98765,
        "firstName": "Jennifer",
        "lastName": "Smith",
        "email": "jennifer@email.com",
        "phone": "555-123-4567",
        "firstAppointment": "2023-06-15",
        "lastAppointment": "2024-01-18",
        "appointmentCount": 12,
        "totalSpent": 1800.00,
        "notes": "Prefers afternoon appointments"
      }
    ],
    "totalCount": 250
  }
}

Availability

{
  "task": "get_availability",
  "success": true,
  "data": {
    "appointmentTypeId": 1,
    "calendarId": 1,
    "month": "2024-01",
    "availableSlots": [
      { "date": "2024-01-22", "time": "09:00", "datetime": "2024-01-22T09:00:00-0800" },
      { "date": "2024-01-22", "time": "10:00", "datetime": "2024-01-22T10:00:00-0800" },
      { "date": "2024-01-22", "time": "14:00", "datetime": "2024-01-22T14:00:00-0800" }
    ]
  }
}

Getting Acuity API Credentials

1. Log in to your Acuity account
2. Go to Integrations → API
3. Find your User ID and API Key
4. Use these in the actor configuration

Note: API access requires Acuity Powerhouse plan or higher.

Integrations

Results can be sent directly to:

• Zapier: Automate appointment follow-ups
• Make (Integromat): Build booking workflows
• n8n: Self-hosted automation
• Custom Webhooks: Your CRM or analytics

Pricing

Pay only for what you use:

• Appointment Query: $0.01 per query
• Client Lookup: $0.01 per lookup
• Availability Check: $0.01 per check
• Calendar Query: $0.005 per query
• Package/Product Query: $0.005 per query

Support

• Acuity API Documentation
• Acuity Help Center

Legal

This actor integrates with the official Acuity Scheduling API. Users must have valid API credentials. Data usage is subject to Acuity/Squarespace Terms of Service.