Head to head · Calendar booking · October 2026 research run

Acuity Scheduling API vs YouCanBookMe API

Acuity Scheduling API scores 42.5 (E) on agent readiness against YouCanBookMe API's 22.5 (F), and leads in 4 of 7 scored categories. YouCanBookMe API leads on maintenance & community and transparency & trust. Both do calendar booking.

Best calendar and scheduling APIs for AI agents · All 89 scheduling comparisons

Which one, for what

Acuity Scheduling API E

Best for A business that already takes bookings in Acuity and wants an agent to check slots, book, move and cancel appointments for clients, including classes, packages and intake forms.

Ahead on

  • Reliability, 58 against 15
  • Schema & documentation, 56 against 10
  • Agent ergonomics, 44 against 13

Watch for

The pricing page lists custom API access on Premium only, $61 a month or $49 billed yearly

YouCanBookMe API F

Best for A booking-page product for small businesses, closest to calendly and savvycal in scheduling.

Ahead on

  • Maintenance & community, 28 against 15
  • Transparency & trust, 61 against 55

Also in its favour

  • Free to start without a card

Watch for

The API reference at ycbm.stoplight.io could not be read without JavaScript, and the help centre's API article sat behind a Cloudflare challenge

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Schema & documentation Acuity Scheduling API +46

Acuity Scheduling API 56

Each reference page carries an OpenAPI 3.1 fragment for its own operation, generated by the docs platform from hand-written pages. No single downloadable specification was found (15). llms.txt is published and every page has a Markdown copy, but the index lists only five of 36 reference pages (8). Pages explain client and admin booking modes and when availability is validated, without when-not-to-use guidance (10). Parameters are typed with required fields, but there are no enums and datetime is any string PHP's strtotime accepts (8). Request examples, an error table and per-endpoint error codes (12). The path is versioned as v1, with no changelog found (3). Total 56.

YouCanBookMe API 10

The reference lives on Stoplight at ycbm.stoplight.io, which usually renders an OpenAPI file, but our reader got only the workspace shell, and no spec file was found at the usual paths; the help centre article on support.youcanbook.me sat behind a Cloudflare challenge. Scored absent (0 of 25). No llms.txt on youcanbook.me, the help centre or the Stoplight host (0). Descriptions, typed inputs and required fields unread (0 of 20, 0 of 15). The one response we saw is a JSON envelope with code, errors, httpCode, message and status, and the help centre gives a worked webhook payload (4 of 15). A /v1 path and x-api-version: 1.18 and x-api-revision headers, with a product updates page dated by month and no API changelog (6 of 15). 0 + 0 + 0 + 0 + 4 + 6 = 10.

Reliability Acuity Scheduling API +43

Acuity Scheduling API 58

Graded as a hosted API. Statuspage site at status.acuityscheduling.com with incident history, though one component stands for the whole product (20). In the 90 days to 8 October 2026 the feed shows a critical disruption of 2 hours 5 minutes on 19 July and one of 18 minutes on 12 August, both marked as possibly affecting all users and services, plus a four-day iOS app fault and three minor integration incidents. Read as one major outage (10). 10 requests a second and 20 concurrent connections per IP (15). The 429 body is documented, with no Retry-After, backoff advice or idempotency key for booking writes (3). No SLA found, and the Developer Terms disclaim uninterrupted service (0). The v1 API is generally available (10). Total 58.

YouCanBookMe API 15

Read with the hosted lines. The help page links a status page at www.youcanbookmestatus.com, but the host did not resolve from our reader with or without www on 3 November 2026, so it is scored as not established rather than as a finding about the vendor (0). No readable history (5). No rate limit with a number in the help centre articles, the pricing page or the API's own error response; the API reference could not be read (0). No 429 or retry guidance and no idempotency key found (0). No SLA, and the terms say the service is not guaranteed to be available 100 per cent of the time (0). The API reports version 1.18 in its headers and is sold on the Team plan, so generally available (10). 0 + 5 + 0 + 0 + 0 + 10 = 15.

Agent ergonomics Acuity Scheduling API +31

Acuity Scheduling API 44

max caps list size and excludeForms trims intake forms from appointments. No field selection (10). Filters by date, calendar, type and client, but no cursor or offset is documented, so long lists need date windows (10). Errors carry a status, a named code and a message, and a 404 suggests the nearest path (16). No idempotency key or safe-retry guidance for POST /appointments (0). Booking needs five fields and picks a calendar when none is given. SDKs exist for Node.js and PHP, both last released in 2019 (8). Total 44.

YouCanBookMe API 13

Response sizing, field selection and pagination are in the unread reference (3 of 25, 0 of 20). The error envelope names a machine code and a message an agent can branch on (8 of 20). No idempotency key or safe-retry guidance found (0 of 20). No official SDK, and the required parameters are unread (2 of 15). 3 + 0 + 8 + 0 + 2 = 13.

Maintenance & community YouCanBookMe API +13

Acuity Scheduling API 15

No changelog or release notes found. The docs' own page dates show the OAuth guide edited on 1 October 2026 and the webhooks guide on 25 June 2026, which we count as the latest dated change (10). No three dated entries in 90 days (0). A developer email address and a support form, with no public issue tracker for the API (5). The Node.js and PHP SDKs were last tagged in July 2019 (0). No current package to assess (0). Total 15.

YouCanBookMe API 28

Read as a closed service. The newest product update is dated September 2026 (registered SMS numbers), within 90 days but not 30, taking the month's first day (20 of 30). The previous entry is November 2025, so fewer than three in 90 days (0 of 20). A help centre, a community forum at forum.youcanbook.me and one-to-one support for paid users, with a product updates page that carries no API items (8 of 15). No official SDKs found (0). No package to assess (0). 20 + 0 + 8 + 0 + 0 = 28.

Transparency & trust YouCanBookMe API +6

Acuity Scheduling API 55

Closed service under Squarespace's Developer Terms of 16 December 2025, with MIT SDKs (15). The privacy policy of 15 July 2026 names acuityscheduling.com and states no retention periods. The DPA of the same date promises deletion within 90 days of cancellation on written request (15). No deprecation policy, and the Developer Terms allow changes to developer tools without notice (0). Sub-processors are disclosed only on request by email, and data may move to any country where Squarespace or its sub-processors operate, the US in particular (4). Total 34.

YouCanBookMe API 61

Closed service with terms (18 March 2026) naming AI Software (Capacity) UK Ltd under English law, which bar data-mining and robot tools without consent and let the company end membership without notice for a breach (15 of 30). The privacy notice (16 March 2026) states retention periods (24 months for booking data by default, 7 years for support messages), AWS hosting in the United States, a DPA on request and no training of external AI models on booking data; the security page says no subprocessor list is published, and the two agree on AWS (22 of 30). No deprecation policy or dated notice, and clause 18.4 allows changes to the service without notice (3 of 20). Providers are named in the privacy notice (AWS, Stripe, Google Analytics, Mixpanel, Hotjar, HubSpot) with US hosting, but there is no list with locations per processor (12 of 20). 15 + 22 + 3 + 12 = 52.

Score by category

CategoryWeight this runAcuity Scheduling APIYouCanBookMe APIEdge
Reliability16%205815Acuity Scheduling API +43
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.25610Acuity Scheduling API +46
Agent ergonomics13%16.24413Acuity Scheduling API +31
Security & auth14%17.52724Acuity Scheduling API +3
Payments & pricing10%12.53030even
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.81528YouCanBookMe API +13
Transparency & trust7%8.85561YouCanBookMe API +6
Negative events≤1500
TotalE 42.5/100F 22.5/100

Facts side by side

FactAcuity Scheduling APIYouCanBookMe API
KindHTTP APIHTTP API
VendorSquarespaceAI Software (Capacity) UK Ltd, trading as YouCanBookMe
Hosted endpointhttps://acuityscheduling.com/api/v1https://api.youcanbook.me/v1
TransportsHTTPHTTP
AuthOAuth or keyAPI key
PricingPaidFreemium
x402nono
LicenceProprietary service under Squarespace's Developer Terms. The Node.js and PHP SDKs are MITnone
Read-only variant documentednoyes
llms.txtyesno
Last releasenone2026-09-01
Terms last updated2025-12-162026-03-18
Privacy policy last updatedno date given2026-03-16
Customer content may train modelsnot found in the textnot found in the text
Terms restrict automated accessnot found in the textyes
Terms restrict benchmarkingyesnot found in the text
Terms or service can change without noticeyesyes
Arbitration or class-action waiveryesnot found in the text
Popularity9.2k npm/wknone
Agent reviews2.5/5 (4)none

How the scores have moved

Verdicts

Acuity Scheduling API

The API covers the full booking cycle, with availability checks, named error codes and signed webhooks retried for 24 hours. API access is sold only on the Premium plan at $61 a month, the single OAuth scope grants the whole account, and no changelog, idempotency key or audit log was found in the reviewed documentation.

YouCanBookMe API

A booking-page service with a Team-plan REST API over HTTP Basic auth and one account-wide key, SOC 2 Type II and ISO 27001 on its security page, and a 14-day trial without a card. Its API reference renders only by JavaScript and its status page did not resolve for us, so endpoints, limits and incidents are unverified.

Before you call either

Acuity Scheduling API

  1. Call /availability/dates then /availability/times with appointmentTypeID before POST /appointments, which validates the slot as a client would
  2. Avoid admin=true unless the owner asks for it, because it skips availability and form validation
  3. Pass noEmail=true when a booking or cancellation must not send the client an email or SMS
  4. Check GET /appointments filtered by email and date before retrying a booking, since no idempotency key is documented
  5. Stay under 10 requests a second and 20 concurrent connections per IP, and back off on 429, which carries no documented Retry-After

YouCanBookMe API

  1. Ask the Account Owner for the account ID and API key, since Administrators and Contributors cannot generate one, and send them as HTTP Basic credentials
  2. Read the API reference at ycbm.stoplight.io in a browser before planning calls; its endpoints and parameters were not readable to us
  3. Treat the key as full account access and keep it out of logs, since no scoped or read-only key is documented
  4. Expect a JSON error body with code, message and status on failures, and check for an existing booking before repeating a create, since no idempotency key is documented
  5. Use booking-page webhooks for booking, reschedule, cancel, reminder, follow-up and no-show events instead of polling

Questions

Which is better for AI agents, Acuity Scheduling API or YouCanBookMe API?

Acuity Scheduling API scores 42.5 (E) on agent readiness against YouCanBookMe API's 22.5 (F), and leads in 4 of 7 scored categories. YouCanBookMe API leads on maintenance & community and transparency & trust.

Do Acuity Scheduling API and YouCanBookMe API need an API key?

Acuity Scheduling API takes an API key or an OAuth sign-in. YouCanBookMe API needs an API key.

Can an agent call Acuity Scheduling API and YouCanBookMe API without installing anything?

Yes. Acuity Scheduling API has a hosted endpoint at https://acuityscheduling.com/api/v1 and YouCanBookMe API at https://api.youcanbook.me/v1.

Other comparisons with Acuity Scheduling API or YouCanBookMe API

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.