Vagaro Integration Setup Guide

i

Before You Begin

What you'll need and estimated time

                Requirements
                An active Vagaro Pro business account
Admin access to your Vagaro dashboard
A business email address
About 10-15 minutes to complete the setup

            

Timeline Overview

Step 1: Request API Access

Send a request to Vagaro's developer team

5 minutes + 1-3 business days wait

Step 2: Receive Credentials

Vagaro will email your API credentials

Automatic after approval

Step 3: Configure RinglyPro

Enter your credentials in RinglyPro settings

5 minutes

Step 4: Set Up Webhooks

Configure real-time updates in Vagaro

5 minutes

1

Request API Access from Vagaro

Send an email to Vagaro's developer team

Vagaro requires businesses to request API access before they can integrate with third-party platforms like RinglyPro. Use the email template below to speed up your approval.

Tip: Send this email from your business email address that's associated with your Vagaro account for faster processing.

Email Template - API Access Request

To: api@vagaro.com

Subject: API Access Request - [Your Business Name]

Hello Vagaro Developer Team, I am requesting API access for my business to integrate with RinglyPro, an AI-powered appointment booking and customer management platform. Business Information: - Business Name: [YOUR BUSINESS NAME] - Vagaro Account Email: [YOUR VAGARO EMAIL] - Business Type: [Salon/Spa/Fitness/etc.] - Location: [City, State] Integration Purpose: We want to use RinglyPro's AI phone assistant to: - Allow customers to book appointments via phone calls - Sync appointment data in real-time - Receive webhook notifications for appointment changes API Features Needed: - OAuth 2.0 authentication (client_credentials) - Appointments API (create, read, update, cancel) - Customers API (create, read, update) - Services API (read) - Employees/Staff API (read) - Webhooks for real-time notifications RinglyPro Integration Details: - Company: RinglyPro (https://ringlypro.com) - Webhook URL: https://aiagent.ringlypro.com/api/mcp/webhooks/vagaro - This is a trusted SaaS platform serving multiple businesses Please let me know the next steps to obtain my API credentials. Thank you, [YOUR NAME] [YOUR PHONE NUMBER] [YOUR BUSINESS NAME]

Open Email Client

Processing Time: Vagaro typically responds within 1-3 business days. If you don't hear back within 5 business days, follow up with another email or call Vagaro support.

2

Receive Your API Credentials

Understanding what Vagaro will send you

Once approved, Vagaro will send you an email with your API credentials. Here's what to look for:

Credential	What It Looks Like	Where to Enter in RinglyPro
Client ID	`abc123def456...` (long alphanumeric string)	Vagaro Client ID (OAuth)
Client Secret Key	`xyz789secret...` (long alphanumeric string)	Vagaro Client Secret Key (OAuth)
Merchant ID	`12345678` (numeric, 6-10 digits)	Vagaro Merchant ID

Security Note: Your Client Secret Key is like a password. Never share it publicly or include it in emails. RinglyPro stores it securely and encrypted.

Finding Your Merchant ID

If Vagaro didn't include your Merchant ID in the email, you can find it in your Vagaro dashboard:

1
Log into Vagaro Pro Go to vagaro.com and sign in to your business account
2
Open Settings Click the gear icon in the top right corner
3
Go to Business Info Your Merchant ID is usually displayed here, or in the URL of your booking page

3

Enter Credentials in RinglyPro

Configure your Vagaro integration

Now that you have your credentials, enter them in RinglyPro:

1
Go to Vagaro Settings From your RinglyPro dashboard, click Settings > Vagaro Integration
2
Enable the Integration Toggle "Enable Vagaro Integration" to ON
3
Enter Your Credentials Copy and paste each credential from Vagaro's email into the corresponding field
4
Select Your Region Choose your Vagaro region (usually US-01 for United States)
5
Save and Test Click "Save Settings" then "Test Connection" to verify everything works

Go to Vagaro Settings

4

Set Up Webhooks in Vagaro

Enable real-time appointment updates

Webhooks allow Vagaro to notify RinglyPro instantly when appointments are created, changed, or cancelled. This keeps everything in sync automatically.

Your Webhook URL

https://aiagent.ringlypro.com/api/mcp/webhooks/vagaro

Configure Webhooks in Vagaro

1
Open Vagaro Settings Log into your Vagaro Pro account and click the Settings gear icon
2
Navigate to Developers Go to Settings > Developers > APIs & Webhooks
3
Create New Webhook Click "Create Webhook" or "Add Webhook"
4
Enter Webhook URL Paste the URL shown above: https://aiagent.ringlypro.com/api/mcp/webhooks/vagaro
5
Select Events Choose these events to subscribe to:
- Appointment Created
- Appointment Updated
- Appointment Cancelled
- Customer Created (optional)
- Customer Updated (optional)
6
Copy Verification Token Vagaro will generate a verification token. Copy this token - you'll need it for RinglyPro
7
Save Webhook in Vagaro Click Save to activate the webhook
8
Enter Token in RinglyPro Go back to RinglyPro Vagaro settings and paste the verification token, then save

You're Done! Once webhooks are configured, RinglyPro's AI assistant can book appointments directly into your Vagaro calendar, and you'll receive real-time updates.

?

Frequently Asked Questions

Common questions and troubleshooting

How long does API approval take?

Vagaro typically responds within 1-3 business days. If you haven't heard back in 5 business days, send a follow-up email or contact Vagaro support directly.

What if my API request is denied?

This is rare, but if it happens, contact RinglyPro support. We can help you draft a more detailed request or explore alternative integration options.

The "Test Connection" button shows an error. What should I do?

Double-check that you've entered all credentials correctly, including the region setting. The most common issues are:

Typos in the Client ID or Secret Key
Wrong region selected
Credentials haven't been activated by Vagaro yet

Do I need to pay extra for API access?

Vagaro's API access is typically included with Vagaro Pro subscriptions at no additional cost. Check with Vagaro if you're unsure about your plan.

Can I disconnect the integration later?

Yes, you can disable the integration at any time from your RinglyPro Vagaro settings page. Your Vagaro data and appointments will remain intact.

I don't see the Developers section in my Vagaro dashboard

The Developers section may only appear after your API access has been approved. If you've received your credentials but still don't see it, contact Vagaro support.

Need Help?

We're here to assist you

If you run into any issues during setup, our support team is ready to help:

Email Support Help Center