← API reference

Website embed

Put topcal on your site with a normal link, button, or iframe. Do not use REST, MCP, or OpenAPI for a simple booking CTA — no API key and no SDK required.

1. Copy your booking URL

In the dashboard open Event Types → Share & embed. Use the exact public slug shown there (for example /{workspace}/{username}/{eventSlug}). Changing the event name does not change a published slug unless you edit the URL slug field.

2. Paste a link or button

Recommended for marketing sites: a normal <a href> so humans and AI assistants can follow it to the bookable page.

<a href="https://topcal.ai/{workspace}/{username}/{eventSlug}"
   target="_blank" rel="noopener"
   style="display:inline-block;padding:10px 18px;background:#111;color:#fff;border-radius:8px;font:600 14px system-ui,sans-serif;text-decoration:none">
  Book a meeting
</a>

3. Optional iframe embed

<iframe
  src="https://topcal.ai/{workspace}/{username}/{eventSlug}"
  title="Book a meeting"
  width="100%" height="720" loading="lazy"
  style="border:1px solid #e5e5e5;border-radius:12px"></iframe>

Need the agent / REST surface instead? See the API reference or API keys.