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-selected3. 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.
Stop sending people the wrong link.
$20/month or $200/year per user · Opening to the waitlist first · Book a demo