> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Acuity Scheduling

> Integration details and setup guide for the Acuity Scheduling connector in Alloy Automation.

## Pre-Built Tooling

| Category                            | Details                                     |
| ----------------------------------- | ------------------------------------------- |
| **Authentication**                  | HTTP Basic Authentication (User ID/API Key) |
| **Two-Way Sync**                    | Yes                                         |
| **Events Supported**                | Yes (Webhooks)                              |
| **Realtime**                        | Yes (API-based)                             |
| **Supports Rate Limiting**          | Yes (10 requests per second)                |
| **Authentication Scopes Supported** | N/A (credentials are User ID and API Key)   |

***

## Objects Supported

Alloy Automation supports syncing the following objects from **Acuity Scheduling**:

* **Appointments**
* **Clients**
* **Calendars**
* **Appointment Types**
* **Availability**
* **Blocks** (Blocked Time)
* **Forms**
* **Coupons**
* **Products**
* **Certificates**

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                                     |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Offers free trial?**                             | Yes. Acuity Scheduling offers a free 7-day trial. Sign up at [https://acuityscheduling.com](https://acuityscheduling.com). |
| **Requires requires paid sandbox**                 | No paid sandbox required. You can test with your trial account.                                                            |
| **Requires partnership to obtain authentication?** | No. You can obtain API credentials directly from your Acuity Scheduling account settings.                                  |

***

### Authentication (HTTP Basic Authentication)

Acuity Scheduling uses HTTP Basic Authentication with your User ID and API Key.

#### Create your Acuity Scheduling account

1. Sign up for a free trial at **Acuity Scheduling** ([https://acuityscheduling.com](https://acuityscheduling.com)).
2. Once logged in, navigate to **Business Settings** → **Integrations** → **API**.
3. Your **User ID** is displayed at the top of the API page (a numeric value).
4. Click **Show API Key** to reveal your API Key, or generate a new one if needed.
5. Copy your **User ID** and **API Key**.
6. Enter your **User ID** as the username and **API Key** as the password into Alloy Automation.

#### API Documentation

For detailed API documentation, visit: [https://developers.acuityscheduling.com/reference/quick-start](https://developers.acuityscheduling.com/reference/quick-start)

***

## Use Cases

### 1) Automated appointment confirmations

Sync appointment data from Acuity Scheduling to your CRM or communication platform to send automated confirmations, reminders, and follow-up messages, reducing no-shows and improving customer engagement.

### 2) Client data synchronization

Keep client information synchronized between Acuity Scheduling and your CRM or customer database, ensuring your team has access to up-to-date contact information and appointment history across all systems.

### 3) Calendar availability management

Automatically update availability across multiple scheduling platforms by syncing calendar blocks and availability changes from Acuity Scheduling, preventing double-bookings and maintaining consistent scheduling options.

### 4) Revenue and analytics tracking

Pull appointment, product, and coupon data from Acuity Scheduling into your business intelligence or accounting systems for comprehensive revenue tracking, appointment analytics, and financial reporting.

### 5) Custom workflow automation

Trigger custom workflows when appointments are booked, rescheduled, or canceled—such as sending intake forms, preparing meeting materials, or notifying team members—streamlining your operational processes.

***

## API Gotchas

* ⚠️ **Rate limiting:** Acuity Scheduling enforces a rate limit of 10 requests per second. Implement throttling in your integration to avoid 429 responses.
* ⚠️ **Webhook verification:** Acuity Scheduling webhooks include a signature in the request headers. Verify this signature to ensure webhook authenticity and security.
* ⚠️ **Time zones:** All appointment times are returned in the time zone configured in your Acuity Scheduling account. Be mindful of time zone conversions when integrating with other systems.

> For questions or troubleshooting, contact **[support@runalloy.com](mailto:support@runalloy.com)**.