How to Enable Vagaro API and Webhooks: Complete Setup Guide (2026)

What Are Vagaro APIs and Webhooks?

Vagaro APIs and webhooks are developer tools that allow third-party applications to communicate with your Vagaro account in real time. If you want to connect your Vagaro salon, spa, or fitness studio to an external service — like an AI receptionist, a CRM, or a custom reporting tool — you need to enable API and webhook access first.

Vagaro API provides programmatic access to read and write data in your Vagaro account. This includes appointments, customer records, services, and provider availability. It uses OAuth 2.0 authentication with a Client ID and Client Secret.

Vagaro webhooks send real-time notifications to external services whenever specific events occur in your account — such as a new appointment being booked or a customer record being updated. Webhooks use POST requests in JSON format.

This guide covers everything you need to enable both features: account requirements, the activation process, available webhook events, authentication setup, pricing, and common troubleshooting steps.

Why Enable Vagaro API and Webhook Access?

Out of the box, Vagaro is a closed system. Your data lives inside Vagaro and stays there. API and webhook access opens your account to integrations that can:

Automate appointment booking — let external tools like AI phone answering services book directly into your Vagaro calendar
Sync customer data — push new client information from phone calls, web forms, or other channels into Vagaro automatically
Trigger real-time actions — send confirmation texts, update a CRM, or notify your team the moment an appointment is created
Build custom reporting — pull appointment and customer data into dashboards or analytics tools
Connect marketing tools — sync client lists with email marketing platforms or retargeting systems

Without API access, all of these tasks require manual data entry — copying information between systems, which wastes time and introduces errors.

Vagaro API and Webhook Prerequisites

Vagaro does not enable API access by default. You must request it, and your account must meet all of the following requirements:

1. Eligible Vagaro Plan

You must be on one of these paid Vagaro plans:

Computer
Tablet
Pay Desk
PayPro

Free trial accounts are not eligible for API access. If you are currently on a trial, upgrade to a paid plan before requesting access.

2. Active Vagaro Credit Card Processing

Vagaro requires that your account actively uses Vagaro Credit Card Processing to process payments. This is a Vagaro-enforced requirement for all API and webhook access — third-party integrations cannot bypass it.

3. Active Billing Cycle

Your account must have an active billing cycle. Accounts that are suspended, paused, or in arrears will not be approved for API access.

Important: If any of these prerequisites do not apply to your account, resolve them before submitting a request. Vagaro will reject requests from ineligible accounts without explanation in some cases.

How to Request Vagaro API and Webhook Access

The request process is done entirely within your Vagaro account settings. You must use a computer — the Vagaro mobile app does not expose the Developers section.

Step 1: Open Settings

Log in to your Vagaro account at vagaro.com on a desktop or laptop computer
Click Settings from the main navigation
Click All Settings to expand the full settings panel

Step 2: Find the Developers Section

In the settings sidebar, scroll down until you see the Developers section
Click APIs & Webhooks

If this is your first time accessing this section, you will not see any API credentials. Instead, you will see a “Contact Us” button. This is expected — Vagaro disables integration access by default on all accounts.

Step 3: Fill Out the Request Form

Click the Contact Us button
A form appears with two fields

Field 1: “Which webhooks will you use?”

Select the webhook types you need. The available options are:

Appointments — triggers when appointments are created, updated, or cancelled
Customers — triggers when customer records are created or updated

For most integrations, select both Appointments and Customers.

Field 2: “Tell us more about how you plan to use Vagaro’s webhooks”

Describe your integration use case clearly. Vagaro’s team reviews these manually, so be specific about what data you need and why.

Example for an AI receptionist integration:

We are connecting an AI voice receptionist that answers incoming calls, books and manages appointments, and syncs customer records in real time. We need appointment and customer webhook events, along with API access to create, read, and update appointments and customer information.

Click Submit

Step 4: Wait for Approval

Vagaro reviews all API access requests manually. This process typically takes up to 5 business days. You will receive an email notification when your request is approved.

During the waiting period, no further action is required on your part. You cannot expedite the review process.

After Approval: Your Vagaro API Credentials

Once Vagaro approves your request, the APIs & Webhooks section in your settings will display your credentials instead of the “Contact Us” button.

Credentials You Will Receive

Credential	Where to Find It	What It Does
Client ID	APIs & Webhooks > API section	Identifies your application to Vagaro’s API
Client Secret	APIs & Webhooks > API section	Authenticates API requests (keep this private)
Region Identifier	Browser URL bar (e.g., “usa03”)	Routes API calls to the correct Vagaro data center

Security note: Your Client Secret is sensitive. Do not share it in emails, chat messages, or public forums. Only provide it to trusted integration partners through secure channels.

Authentication Method

Vagaro’s API uses OAuth 2.0 for authentication. The typical flow is:

Your integration sends the Client ID and Client Secret to Vagaro’s OAuth endpoint
Vagaro returns an access token
All subsequent API calls include this access token in the request header
Tokens expire periodically and must be refreshed

If you are using a pre-built integration like AgentZap, you simply provide your Client ID and Client Secret — the integration handles the OAuth flow automatically.

Configuring Vagaro Webhooks

After approval, you can configure webhooks to send real-time event notifications to external services.

Available Webhook Event Types

Event Type	Triggers When	Data Included
Appointment Created	A new appointment is booked	Appointment details, client info, provider, service, time
Appointment Updated	An existing appointment is modified	Updated fields, previous values, new values
Appointment Cancelled	An appointment is cancelled	Appointment ID, cancellation reason
Customer Created	A new client record is added	Customer name, contact details, preferences
Customer Updated	An existing client record is modified	Updated fields, previous values, new values

Webhook Configuration Settings

Each webhook requires the following configuration:

Webhook URL: The endpoint where Vagaro sends event data (provided by your integration partner)
Request Method: POST
Request Format: JSON
Location Selection: Choose which business locations trigger this webhook (relevant for multi-location accounts)

Your integration partner will provide the specific webhook URL. For example, if you are connecting to AgentZap, the URL is provided in your AgentZap dashboard under Integrations > Vagaro.

Testing Your Webhooks

After configuring a webhook:

Create a test appointment in Vagaro
Check your integration partner’s dashboard to confirm the event was received
Verify the data matches — correct client name, service, time, and provider
Test an update by rescheduling the test appointment
Test a cancellation to confirm that event type fires correctly

If events are not arriving, verify the webhook URL is correct and that your integration partner’s endpoint is active.

Vagaro API and Webhook Pricing

Vagaro charges a monthly fee for API and webhook access. This is billed directly by Vagaro and is separate from any integration partner fees.

Item	Cost
Monthly base fee	$10/month
Included API/webhook calls	5,000/month
Overage rate	$0.002 per call

How API Calls Are Counted

Every interaction with Vagaro’s API counts as one call. This includes:

Checking provider availability (1 call)
Creating an appointment (1 call)
Updating a customer record (1 call)
Each webhook event notification sent (1 call)

Estimating Your Monthly Usage

Business Type	Daily Activity	Est. Monthly Calls	Within Free Tier?
Small salon (1-3 staff)	10-15 appointments/day	300-600	Yes
Medium salon (4-8 staff)	20-40 appointments/day	600-1,500	Yes
Large salon or spa	50-80 appointments/day	1,500-3,000	Yes
Multi-location (3+ sites)	100+ appointments/day	3,000-6,000	Possible overage

Most single-location Vagaro businesses will stay well within the included 5,000 calls per month. Overage charges only apply if you exceed the limit, and at $0.002 per call, even 10,000 total calls would only cost an additional $10.

Vagaro API Limitations to Be Aware Of

Before building or connecting an integration, understand these limitations of Vagaro’s API:

No historical data import: Vagaro’s API does not support bulk export of historical appointment or customer data. You can only access records going forward from when webhooks are activated.
Manual approval required: There is no instant or self-service API activation. Every account must go through the manual review process.
Desktop only for setup: API and webhook settings are not accessible from the Vagaro mobile app.
Credit card processing required: Accounts without Vagaro’s payment processing cannot access the API regardless of plan tier.
Rate limits: Vagaro applies rate limits to prevent abuse. High-frequency polling may be throttled. Use webhooks for real-time updates instead of repeatedly querying the API.

Integrations That Use Vagaro API and Webhooks

Once your API access is enabled, you can connect Vagaro to a growing number of third-party tools:

AgentZap AI Receptionist — answers phone calls 24/7, books appointments, and captures new clients directly in Vagaro
CRM platforms — sync customer data with tools like HubSpot, Salesforce, or Zoho for marketing and follow-up
Zapier / Make — connect Vagaro to 5,000+ apps through automation workflows (Vagaro’s webhook add-on required)
Custom reporting tools — pull appointment and revenue data into Google Sheets, Power BI, or custom dashboards
Email marketing — automatically add new Vagaro clients to Mailchimp, ActiveCampaign, or Constant Contact lists

For salon owners, spa operators, and fitness studio managers, the most impactful integration is typically AI phone answering — since it directly captures revenue that would otherwise be lost to missed calls.

Frequently Asked Questions

How long does it take to get Vagaro API access approved?

Vagaro reviews API access requests manually. Approval typically takes up to five business days. You will receive an email notification when access is granted. There is no way to expedite the review process.

Can I enable Vagaro webhooks from the mobile app?

No. The Developers section with APIs and Webhooks settings is only accessible from the desktop version of Vagaro at vagaro.com. You must use a computer to request access, configure webhooks, and retrieve your API credentials.

What happens if I exceed 5,000 API calls per month?

Vagaro charges $0.002 per additional call beyond the included 5,000. For example, 7,000 total calls in a month would cost $10 base fee plus $4 in overage charges, totaling $14. Most single-location businesses never exceed the included limit.

Do I need a developer to set up Vagaro webhooks?

If you are connecting to a pre-built integration like AgentZap, no developer is needed. You provide your Client ID and Client Secret, and the integration handles the technical configuration. For custom integrations, you will need a developer familiar with REST APIs and OAuth 2.0 authentication.

Can I use Vagaro API access for free?

No. Vagaro charges $10 per month for API and webhook access regardless of usage volume. This fee is billed directly by Vagaro and is separate from any third-party integration costs. The $10 fee includes 5,000 API calls per month.

Is Vagaro API data available in real time?

Yes. Webhook events fire in real time — the moment an appointment is booked or a customer record is updated, the webhook notification is sent to your configured endpoint. API queries also return current data. However, historical data exports are not supported.

Next Steps

Once your Vagaro API and webhook access is enabled, you are ready to connect integrations that save time and capture more revenue.

The highest-impact integration for most Vagaro businesses is AI phone answering. Research shows 62% of salon calls go unanswered (Source: Salon Today Industry Report, 2025), and each missed call costs an average of $50 to $200 in lost revenue depending on your service pricing.

Ready to put your Vagaro webhooks to work? Book a demo to see how AgentZap uses your Vagaro API connection to answer calls and book appointments 24/7. Or read our step-by-step guide to connecting Vagaro with AgentZap.

For a complete overview of the integration, visit our Vagaro integration page.