# HYROS Installation: Acuity Scheduling

## REQUIREMENTS - Collect Before Starting

| Item | Ask User |
|------|----------|
| HYROS Tracking Code | "Please paste your HYROS tracking code. Get it from: https://app.hyros.com/tracking/universal-script" |
| Acuity Admin Access | "Do you have Acuity Scheduling admin access?" |
| Appointment Types | "Which appointment types do you want to track?" |

**IMPORTANT:** Store the tracking code - you'll add it in Step 3.

---

## STEPS

### Step 1: Open Acuity Settings

**Direct URL:** https://acuityscheduling.com/

**If automating:** Navigate to Acuity → Settings → Integrations or Custom Code.

**If guiding user:** "Go to Acuity → Settings → Integrations"

→ Confirm: "Are you in the settings?"

---

### Step 2: Connect Acuity in HYROS

**Direct URL:** https://app.hyros.com/integrations

**If automating:** Navigate to HYROS integrations, find Acuity, click Connect.

**If guiding user:** "Go to https://app.hyros.com/integrations, find Acuity, and click Connect"

→ Confirm: "Did you start the connection?"

---

### Step 3: Add Tracking Code to Acuity

**If automating:** Find the custom code/tracking section and paste the user's code.

**If guiding user:**
"In Acuity, go to Settings → Custom Code or Tracking
Paste this code:

```
[DISPLAY USER'S TRACKING CODE HERE]
```
"

→ Confirm: "Did you add the tracking code?"

---

### Step 4: Configure Webhook (If Required)

**If automating:** If HYROS provides a webhook URL, add it in Acuity's webhook settings.

**If guiding user:** "If HYROS gives you a webhook URL, go to Acuity → Integrations → Webhooks and add it"

→ Confirm: "Is webhook configured (or not needed)?"

---

### Step 5: Save Settings

**If automating:** Click Save.

**If guiding user:** "Click Save"

→ Confirm: "Did it save?"

---

### Step 6: Verify Installation

**If automating:** Book a test appointment and verify it appears in HYROS.

**If guiding user:** "Book a test appointment and check HYROS for the data"

→ Confirm: "Can you see Acuity appointments in HYROS?"

---

## TROUBLESHOOTING

- **Code not firing:** Check it's in the right custom code section
- **Appointments missing:** Verify webhook is properly configured
- **Cancellations not tracking:** May need additional webhook events

---

## Source
Synced from: docsContent.ts (acuityGuide)
Last synced: 2026-01-03