- Overview
- Introduction to Cal.com Atoms
- Setup
- Apple calendar connect
- Availability settings
- Booker Embed
- Booker
- Bookings hooks
- Cal OAuth Provider
- Cal Provider
- Calendar settings
- Calendar view
- Calendars hooks
- Conferencing Apps
- Create schedule
- Event Type
- Event types hooks
- FAQ
- Google calendar connect
- List Event Types
- List schedules
- Onboarding Embed
- Outlook calendar connect
- Payment form
- Quickstart
- Stripe Connect
- Troubleshooter
- User / Teams hooks
- Bookings hooks
- Calendars hooks
- Event types hooks
- FAQ
- Introduction
- Quickstart
- User / Teams hooks
- Apple calendar connect
- Availability settings
- Booker Embed
- Booker
- Cal OAuth Provider
- Cal Provider
- Calendar settings
- Calendar view
- Conferencing Apps
- Create schedule
- Event Type
- Google calendar connect
- List Event Types
- List schedules
- Outlook calendar connect
- Payment form
- Stripe Connect
- Troubleshooter
- Managing booking fields
- Booking redirects
- Custom booking flow
- Custom slot selection flow
- Global event types
- Managed organizations
- Custom toasts
- Configuring your team
Introduction to Cal.com Atoms
Archived Cal.com Atoms documentation for Introduction to Cal.com Atoms. These deprecated SDK components are no longer maintained.
@calcom/atoms is in maintenance mode. Existing integrations keep receiving fixes and new versions on npm, but no new atoms are planned for this package: the next generation of Atoms will be distributed as copy-and-paste components built on coss ui and API v2. Building on your own Cal.com account? Start from API v2. Building scheduling into your own product, for your own users? Use coss.com Scheduling.
Cal.com Atoms are customizable React components that let you integrate Cal.com scheduling functionality directly into your application. Using OAuth authentication, your users can connect their Cal.com accounts and manage their scheduling without leaving your app.
What are atoms?
Atoms are pre-built UI components that handle:
- Booking - Let users book appointments with Cal.com users
- Availability - Display and manage availability schedules
- Event Types - Create and configure event types
- Calendar Integration - Connect Google, Outlook, and Apple calendars
- Payments - Accept payments via Stripe for bookings
Supported frameworks
Cal.com Atoms currently support:
- React 18 and React 19
- Next.js 14 and Next.js 15
Prerequisites
- An OAuth client created via OAuth setup
- User access tokens obtained through the OAuth flow
Getting started
Ready to integrate atoms into your application? Follow our step-by-step setup guide to get started.
Authentication flow
Atoms with OAuth work with regular Cal.com user accounts:
- User clicks "Connect with Cal.com" in your app
- User authorizes your OAuth client on Cal.com
- You receive access and refresh tokens
- Pass the access token to
CalOAuthProvider - Atoms use this token to make API calls on behalf of the user
See the OAuth documentation for details on implementing the authentication flow.
Last updated