Acuity Scheduling API - Appointments & Booking Data

API Integration

This actor connects to an external API service. You'll need valid API credentials from the service provider.

---

API Integration

This actor connects to an external API service. You'll need valid API credentials from the service provider.

---

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

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

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

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

Output Format

{
  "data": [...]
}

Pricing

This actor uses pay-per-event billing: 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

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

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal