LiveCal
…
Publisher sections ›
Quickstart

Five minutes to a Track button

The whole front end is two lines of HTML. Here's the shortest path from nothing to a real calendar event being written.

  1. Mint a widget key

    Sign in to the dashboard, register your site, and mint a publishable widget key (livecal_pk_…). It's public and safe in page source.

  2. Drop two lines on your page

    Load the embed once, then place a <livecal-track>element wherever the event lives, pointed at your Source's source_id UUID.

  3. Create the Source it points at

    From your backend, upsert the Source so the widget has something to render and you can push live-state. See Create a Source →

HTML — Widget embed
<!-- 1. Load the embed script once, anywhere on the page -->
<script src="https://livecal.ai/embed/v1.js" defer></script>

<!-- 2. Drop a Track Widget wherever the event lives -->
<!--    source = the source_id UUID from the upsert response (NOT your external_id) -->
<!--    pk     = your site's publishable key (livecal_pk_…). PUBLIC + safe in -->
<!--             page source; it origin-pins the analytics beacon and turns on -->
<!--             the live-state line. Recommended; mint it in the console        -->
<!--             (Dashboard → your site → Widget keys).                          -->
<!--             Omit it and the widget still works — keyless, no enrichment.    -->
<livecal-track
  source="3f9a21c8-7b4e-4d2a-9c1f-0a2b3c4d5e6f"
  pk="livecal_pk_REPLACE_WITH_YOUR_SITE_KEY"
></livecal-track>

That's the front end. Next: the full Publisher API reference →