Developers

Booking for websites, SDR bots and AI agents.

Short answer

Put a Hatcal time picker on any website with one script tag, send prefilled booking links from emails, or let an AI SDR agent read open times and book meetings through a small JSON API. Bookings land in the right company calendar with the right Zoom, Teams or Meet, exactly like the booking page.

$20/month or $200/year per user · Opening to the waitlist first · Book a demo

1. Embed on your website

Add the script once, then turn any button into a booking popup, or drop the calendar inline.

<script src="https://hatcal.com/embed.js" async></script>

<!-- Popup -->
<button data-valscal-popup="sublien/demo">Book a demo</button>

<!-- Inline -->
<div data-valscal-inline="sublien/demo"></div>

<!-- Know when someone books -->
<script>
  document.addEventListener("valscal:booked", (e) => {
    // e.detail = { id, link, start, durationMin, name, email, joinUrl }
  });
</script>

Optional attributes pre-fill the form: data-name, data-email, data-notes. From JavaScript: ValsCal.open("sublien/demo", { email }).

2. Prefilled booking links

Any booking page accepts query parameters, which is handy for personalised outreach emails:

https://hatcal.com/sublien/demo?name=Jane%20Doe&email=jane@acme.com
https://hatcal.com/sublien/demo?slot=2026-11-18T15:00:00.000Z   # time already picked
https://hatcal.com/sublien/demo?date=2026-11-18                  # day pre-selected

3. API for AI agents

Read open times. Times are UTC; local is formatted in the tz you pass, so an agent can write “Tue, Nov 17, 10:00 AM” in an email.

GET https://hatcal.com/api/v1/availability?link=sublien/demo&tz=America/New_York

{
  "link": "sublien/demo",
  "title": "SubLien demo",
  "durationMin": 15,
  "location": "Zoom",
  "timezone": "America/New_York",
  "bookingUrl": "https://hatcal.com/sublien/demo",
  "slots": [
    {
      "start": "2026-11-17T15:00:00.000Z",
      "end": "2026-11-17T15:15:00.000Z",
      "local": "Tue, Nov 17, 10:00 AM",
      "bookUrl": "https://hatcal.com/sublien/demo?slot=2026-11-17T15%3A00%3A00.000Z"
    }
  ]
}

Book a slot. The slot is re-checked against every connected calendar. 409 means it was just taken: fetch availability again and offer another time.

POST https://hatcal.com/api/v1/bookings
Content-Type: application/json

{
  "link": "sublien/demo",
  "start": "2026-11-17T15:00:00.000Z",
  "name": "Jane Doe",
  "email": "jane@acme.com",
  "notes": "GC, 40 active subs, uses Procore",
  "tz": "America/New_York",
  "guests": ["sam@acme.com"]
}

→ 201 { "id": "…", "start": "…", "end": "…", "joinUrl": "https://us06web.zoom.us/j/…" }

guests (optional, up to 10) get the calendar invite too. The guest receives a confirmation email with links to add people, reschedule or cancel, plus reminders 24 hours and 1 hour before.

Optional query parameters for availability: from and to (ISO dates, up to 62 days apart; default is the next 14 days).

Developer questions

Can an AI agent book meetings on my calendar?

+

Yes. An agent calls GET /api/v1/availability to read open times for a booking link, then POST /api/v1/bookings to book one. Every booking is re-checked against all connected calendars first, and the guest gets a normal calendar invite with the right Zoom, Teams or Meet link.

Can my SDR send a link with a specific time already picked?

+

Yes. Each slot from the availability API includes a bookUrl. Opening it shows the booking form with that time selected; adding name and email to the URL pre-fills the form too.

How do I add a booking calendar to my website?

+

Add <script src="https://hatcal.com/embed.js" async></script> and put data-valscal-popup="your/link" on any button, or a <div data-valscal-inline="your/link"> where the calendar should appear. The iframe resizes itself.

Can my site track demo bookings from the embed?

+

Yes. The embed fires a valscal:booked event on your page with the booking time, name and email, so you can record the conversion in your own analytics or CRM.

and put data-valscal-popup=\"your/link\" on any button, or a
where the calendar should appear. The iframe resizes itself."}},{"@type":"Question","name":"Can my site track demo bookings from the embed?","acceptedAnswer":{"@type":"Answer","text":"Yes. The embed fires a valscal:booked event on your page with the booking time, name and email, so you can record the conversion in your own analytics or CRM."}}]}

Stop sending people the wrong link.

$20/month or $200/year per user · Opening to the waitlist first · Book a demo