Vagaro API

POST https://cotlet.dev/api/v1/vagaro/list_locations

Returns every location of your Vagaro business. Use location_id from each item in the other calls. Multi-location businesses read one location per call.

Parameters

No parameters.

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/list_locations \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("vagaro", "list_locations")

const result = await cotlet.call('vagaro', 'list_locations');

cotlet call vagaro list_locations

Example response

{
  "locations": [
    {
      "location_id": "loc_21",
      "name": "Main Street",
      "address": "120 Main St, Portland, OR",
      "time_zone": "America/Los_Angeles",
      "phone": "+1 555 0100"
    },
    {
      "location_id": "loc_22",
      "name": "Riverside",
      "address": "8 River Rd, Portland, OR",
      "time_zone": "America/Los_Angeles",
      "phone": "+1 555 0101"
    }
  ]
}

POST https://cotlet.dev/api/v1/vagaro/list_services

Returns the services of one location with duration, price and the providers who perform them. Use service_id in search_availability and book_appointment. Prices are the menu prices shown in Vagaro.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/list_services \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("vagaro", "list_services")

const result = await cotlet.call('vagaro', 'list_services');

cotlet call vagaro list_services

Example response

{
  "services": [
    {
      "service_id": "svc_1172",
      "name": "Balayage",
      "duration_min": 150,
      "price": {
        "amount": 185,
        "currency": "USD"
      },
      "provider_ids": [
        "emp_309"
      ]
    },
    {
      "service_id": "svc_1180",
      "name": "Women's cut",
      "duration_min": 45,
      "price": {
        "amount": 65,
        "currency": "USD"
      },
      "provider_ids": [
        "emp_309",
        "emp_311"
      ]
    }
  ]
}

POST https://cotlet.dev/api/v1/vagaro/list_appointments

Returns appointments of one location between two days, ordered by start time. Filter by provider to read one person's day. Each item has the client, service, provider, status and price shown on the calendar. This reads the calendar by date, which the official API cannot do.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/list_appointments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"2026-10-01"}'

result = client.call("vagaro", "list_appointments", {"from":"2026-10-01"})

const result = await cotlet.call('vagaro', 'list_appointments', {"from":"2026-10-01"});

cotlet call vagaro list_appointments --data '{"from":"2026-10-01"}'

Example response

{
  "appointments": [
    {
      "appointment_id": "apt_7730301",
      "client": "Maya Brooks",
      "service": "Women's cut",
      "provider": "Alex",
      "start": "2026-10-14T09:00:00-07:00",
      "end": "2026-10-14T09:45:00-07:00",
      "status": "Booked"
    },
    {
      "appointment_id": "apt_7730415",
      "client": "Jamie Cole",
      "service": "Balayage",
      "provider": "Alex",
      "start": "2026-10-14T11:30:00-07:00",
      "end": "2026-10-14T14:00:00-07:00",
      "status": "Booked"
    }
  ]
}

POST https://cotlet.dev/api/v1/vagaro/search_availability

Returns open start times for one service in a date range, per provider. Use a start from the result in book_appointment or reschedule_appointment so the booking lands on a free slot.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/search_availability \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service_id":"service_8c41d2","from":"2026-10-01"}'

result = client.call("vagaro", "search_availability", {"service_id":"service_8c41d2","from":"2026-10-01"})

const result = await cotlet.call('vagaro', 'search_availability', {"service_id":"service_8c41d2","from":"2026-10-01"});

cotlet call vagaro search_availability --data '{"service_id":"service_8c41d2","from":"2026-10-01"}'

Example response

{
  "slots": [
    {
      "provider_id": "emp_309",
      "provider": "Alex",
      "start": "2026-10-15T10:00:00-07:00"
    },
    {
      "provider_id": "emp_309",
      "provider": "Alex",
      "start": "2026-10-15T14:30:00-07:00"
    }
  ]
}

POST https://cotlet.dev/api/v1/vagaro/find_client

Searches your customers by name, email or phone and returns contact details and tags. Use client_id in book_appointment and add_to_waitlist. The official API needs a customer ID up front; this finds the ID from what you know.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/find_client \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"query"}'

result = client.call("vagaro", "find_client", {"query":"query"})

const result = await cotlet.call('vagaro', 'find_client', {"query":"query"});

cotlet call vagaro find_client --data '{"query":"query"}'

Example response

{
  "clients": [
    {
      "client_id": "cl_48213",
      "name": "Jamie Cole",
      "email": "jamie@example.com",
      "phone": "+1 555 0142",
      "tags": [
        "color"
      ]
    }
  ]
}

POST https://cotlet.dev/api/v1/vagaro/list_waitlist

Returns the waitlist of one location. Each entry has the client, the service and provider they asked for and the day. Use entry IDs in notify_waitlist. Which alerts Vagaro sends on its own depends on your waitlist mode under Online Appointment Rules.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/list_waitlist \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("vagaro", "list_waitlist")

const result = await cotlet.call('vagaro', 'list_waitlist');

cotlet call vagaro list_waitlist

Example response

{
  "entries": [
    {
      "waitlist_entry_id": "wl_2041",
      "client": "Maya Brooks",
      "service": "Women's cut",
      "provider": "Alex",
      "date": "2026-10-14"
    },
    {
      "waitlist_entry_id": "wl_2044",
      "client": "Sam Ortiz",
      "service": "Beard trim",
      "provider": "any",
      "date": "2026-10-14"
    }
  ]
}

POST https://cotlet.dev/api/v1/vagaro/list_conversations

Returns your Connect chats with clients, most recent first, with the last message and whether it is unread. Set unread_only to see what needs an answer. Replies to appointment notifications do not appear here.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/list_conversations \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("vagaro", "list_conversations")

const result = await cotlet.call('vagaro', 'list_conversations');

cotlet call vagaro list_conversations

Example response

{
  "conversations": [
    {
      "conversation_id": "cv_2290",
      "client": "Maya Brooks",
      "unread": true,
      "last_message": "How much is a cut with Alex?",
      "updated_at": "2026-10-13T16:02:00-07:00"
    }
  ]
}

POST https://cotlet.dev/api/v1/vagaro/list_reviews

Returns the reviews posted on your Vagaro listing page, newest first, with rating, text and whether you replied. Use unanswered_only to skip reviews you already answered. You cannot remove a customer review in Vagaro, so this tool only reads them.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/list_reviews \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location_id":"loc_21","since":"2026-10-06","unanswered_only":true}'

result = client.call("vagaro", "list_reviews", {"location_id":"loc_21","since":"2026-10-06","unanswered_only":True})

const result = await cotlet.call('vagaro', 'list_reviews', {"location_id":"loc_21","since":"2026-10-06","unanswered_only":true});

cotlet call vagaro list_reviews --data '{"location_id":"loc_21","since":"2026-10-06","unanswered_only":true}'

Example response

{
  "reviews": [
    {
      "review_id": "rv_5521",
      "client": "Maya B.",
      "rating": 5,
      "text": "Best balayage I have had.",
      "posted_at": "2026-10-12",
      "replied": false
    }
  ]
}

POST https://cotlet.dev/api/v1/vagaro/book_appointment

Books one client for one service with one provider at a start time from search_availability. Returns the appointment, its end time and price. The booking appears on the Vagaro calendar like one made by staff. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/book_appointment \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"cl_48213","service_id":"svc_1172","provider_id":"emp_309","start":"2026-10-16T14:00:00-07:00","notes":"Booked by agent from a Connect request"}'

result = client.call("vagaro", "book_appointment", {"client_id":"cl_48213","service_id":"svc_1172","provider_id":"emp_309","start":"2026-10-16T14:00:00-07:00","notes":"Booked by agent from a Connect request"})

const result = await cotlet.call('vagaro', 'book_appointment', {"client_id":"cl_48213","service_id":"svc_1172","provider_id":"emp_309","start":"2026-10-16T14:00:00-07:00","notes":"Booked by agent from a Connect request"});

cotlet call vagaro book_appointment --data '{"client_id":"cl_48213","service_id":"svc_1172","provider_id":"emp_309","start":"2026-10-16T14:00:00-07:00","notes":"Booked by agent from a Connect request"}'

Example response

{
  "appointment_id": "apt_7730415",
  "status": "Booked",
  "client_id": "cl_48213",
  "service": "Balayage",
  "provider": "Alex",
  "start": "2026-10-16T14:00:00-07:00",
  "end": "2026-10-16T16:30:00-07:00",
  "price": {
    "amount": 185,
    "currency": "USD"
  }
}

POST https://cotlet.dev/api/v1/vagaro/reschedule_appointment

Moves one appointment to a new start time and optionally a new provider, the same change as dragging it on the calendar. Returns the old and new times. Pick the new start from search_availability. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/reschedule_appointment \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appointment_id":"apt_7730301","start":"2026-10-14T09:00:00-07:00","provider_id":"emp_311"}'

result = client.call("vagaro", "reschedule_appointment", {"appointment_id":"apt_7730301","start":"2026-10-14T09:00:00-07:00","provider_id":"emp_311"})

const result = await cotlet.call('vagaro', 'reschedule_appointment', {"appointment_id":"apt_7730301","start":"2026-10-14T09:00:00-07:00","provider_id":"emp_311"});

cotlet call vagaro reschedule_appointment --data '{"appointment_id":"apt_7730301","start":"2026-10-14T09:00:00-07:00","provider_id":"emp_311"}'

Example response

{
  "appointment_id": "apt_7730415",
  "status": "Booked",
  "previous_start": "2026-10-14T11:30:00-07:00",
  "start": "2026-10-15T10:00:00-07:00",
  "end": "2026-10-15T12:30:00-07:00",
  "provider": "Alex"
}

POST https://cotlet.dev/api/v1/vagaro/cancel_appointment

Cancels one appointment, as Change Status then Cancel does on the Vagaro calendar. Set notify_client to tell the client. Refunds of prepayments and cancellation fees are not part of this tool; handle those in Vagaro. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/cancel_appointment \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appointment_id":"appointment_8c41d2"}'

result = client.call("vagaro", "cancel_appointment", {"appointment_id":"appointment_8c41d2"})

const result = await cotlet.call('vagaro', 'cancel_appointment', {"appointment_id":"appointment_8c41d2"});

cotlet call vagaro cancel_appointment --data '{"appointment_id":"appointment_8c41d2"}'

Example response

{
  "appointment_id": "apt_7730415",
  "status": "Cancelled",
  "client_notified": true
}

POST https://cotlet.dev/api/v1/vagaro/add_to_waitlist

Adds a client to the waitlist of a location for one service and day, as Vagaro lets staff do by hand. The date tells Vagaro when to notify the client. Returns the entry ID for list_waitlist. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/add_to_waitlist \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"client_8c41d2","service_id":"service_8c41d2","date":"2026-10-01"}'

result = client.call("vagaro", "add_to_waitlist", {"client_id":"client_8c41d2","service_id":"service_8c41d2","date":"2026-10-01"})

const result = await cotlet.call('vagaro', 'add_to_waitlist', {"client_id":"client_8c41d2","service_id":"service_8c41d2","date":"2026-10-01"});

cotlet call vagaro add_to_waitlist --data '{"client_id":"client_8c41d2","service_id":"service_8c41d2","date":"2026-10-01"}'

Example response

{
  "waitlist_entry_id": "wl_2052",
  "client": "Jamie Cole",
  "service": "Women's cut",
  "date": "2026-10-17",
  "provider": "any"
}

POST https://cotlet.dev/api/v1/vagaro/notify_waitlist

Offers an open slot to the waitlist entries you pick, like choosing a client by hand in the You Pick mode. Returns how many clients were alerted. Clients receive the alert, so it reaches people outside your account. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/notify_waitlist \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"waitlist_entry_ids":["waitlist entry ids"],"start":"2026-10-01T09:00:00Z"}'

result = client.call("vagaro", "notify_waitlist", {"waitlist_entry_ids":["waitlist entry ids"],"start":"2026-10-01T09:00:00Z"})

const result = await cotlet.call('vagaro', 'notify_waitlist', {"waitlist_entry_ids":["waitlist entry ids"],"start":"2026-10-01T09:00:00Z"});

cotlet call vagaro notify_waitlist --data '{"waitlist_entry_ids":["waitlist entry ids"],"start":"2026-10-01T09:00:00Z"}'

Example response

{
  "alerted": 1,
  "waitlist_entry_ids": [
    "wl_2041"
  ],
  "start": "2026-10-14T14:00:00-07:00",
  "provider": "Alex"
}

POST https://cotlet.dev/api/v1/vagaro/reply_to_client

Sends a message in an existing Connect chat. Set include_booking_link to add your appointment booking link. Once a client has closed a chat, Vagaro needs a messaging plan on your side before you can keep replying. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/reply_to_client \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":"conversation_8c41d2","body":"body"}'

result = client.call("vagaro", "reply_to_client", {"conversation_id":"conversation_8c41d2","body":"body"})

const result = await cotlet.call('vagaro', 'reply_to_client', {"conversation_id":"conversation_8c41d2","body":"body"});

cotlet call vagaro reply_to_client --data '{"conversation_id":"conversation_8c41d2","body":"body"}'

Example response

{
  "conversation_id": "cv_2290",
  "message_id": "msg_8814",
  "status": "sent",
  "sent_at": "2026-10-13T16:10:00-07:00"
}

POST https://cotlet.dev/api/v1/vagaro/reply_to_review

Posts your reply under one review. The reply is public to other Vagaro users, the customer is notified, and the customer cannot comment again. There is no edit tool; edit or delete a reply in Vagaro on the web, tablet, Pay Desk or PayPro. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/vagaro/reply_to_review \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"review_id":"review_8c41d2","body":"body"}'

result = client.call("vagaro", "reply_to_review", {"review_id":"review_8c41d2","body":"body"})

const result = await cotlet.call('vagaro', 'reply_to_review', {"review_id":"review_8c41d2","body":"body"});

cotlet call vagaro reply_to_review --data '{"review_id":"review_8c41d2","body":"body"}'

Example response

{
  "review_id": "rv_5521",
  "status": "published",
  "replied_at": "2026-10-13T16:20:00-07:00"
}