Skip to main content
Connect your Google or Microsoft calendar in Atonom to enable meeting scheduling. After OAuth, configure Meeting Settings and Availability Settings so Atonom can find open times and book meetings on your calendar—for Cloud Employees, the API, and other booking flows. For OAuth scopes, admin setup, and permission details, see OAuth & Permissions. For creating meeting types and how they work with booking, see Meeting Types. Microsoft tenants can optionally restrict who may connect a calendar using an Entra security group.

Overview

Open My Settings → My Calendar in the Atonom app (/#/v2/my_settings/my_calendar). From there you will:
  1. Connect Google or Microsoft via OAuth
  2. Configure meeting preferences (links, buffer time, lead time)
  3. Set availability (timezone, selected calendars, weekly hours)
That is all that is required for meeting booking through Cloud Employees, the API, and other Atonom flows. Optionally, you can also enable self-service booking on your profile page (see below).

Connect your calendar

  1. Go to My Settings → My Calendar
  2. On the Calendar Connection card, choose Microsoft or Google
  3. Complete the OAuth sign-in and grant the requested permissions
  4. You are redirected back to My Calendar, where Meeting Settings and Availability Settings appear
Calendar Connection card with Microsoft and Google options
Calendar connection is per-user. Each person authorizes their own mailbox and calendar access.
On first connect, Atonom applies these defaults: You can change all of these in Availability Settings after connecting. To remove a connection, use Disconnect Calendar at the top of the My Calendar page. This removes stored OAuth tokens from Atonom but does not revoke the app in Google or Microsoft.

Post-connection setup checklist

Complete these steps after connecting your calendar:
  1. Configure Meeting Settings and click Save Settings
  2. Review Availability Settings (timezone, selected calendars, weekly hours) — changes save automatically
Enabling Allow visitors to book a meeting with me on My Profile is optional. It only controls self-service booking on your public profile page and is not required for Cloud Employees, the Schedule a Meeting API, or other booking flows.

Meeting Settings

The Meeting Settings card controls how booked meetings behave and what information is included in invitations.
Meeting settings do not auto-save. Click Save Settings after making changes.
Direct calendar integrations support two conferencing options on My Calendar → Meeting Settings:
  • Auto-generate links (recommended) — creates native Google Meet or Microsoft Teams join links based on your connected calendar.
  • Use personal meeting link — paste a Zoom, Teams, or other URL; it is included on booked calendar invites.
Zoom and GoToMeeting auto-generation on direct calendar is not supported; use a personal link for those providers. Meeting Settings and Availability Settings on My Calendar

Buffer and lead time options

Buffer time: No buffer, 15 min, 30 min, 45 min, 1 hour, 1 hr 15 min, 1 hr 30 min, 1 hr 45 min, 2 hours Lead time: No lead time, 15 min, 30 min, 45 min, 1 hour, 1 hr 30 min, 2 hours, 3 hours, 4 hours, 5 hours, 6 hours, 7 hours, 8 hours, 12 hours, 24 hours, 48 hours

How lead time is applied

Each meeting type in Atonom can also have its own lead time configured by an admin. When availability is calculated for a booking, Atonom uses the longer of the two values:
  • Personal lead time from your Meeting Settings
  • Lead time configured on the meeting type being booked
For example, if your personal lead time is 15 minutes but the meeting type requires 2 hours, visitors cannot book a slot starting within the next 2 hours. If your personal lead time is 24 hours but the meeting type requires 1 hour, the 24-hour personal setting applies. This applies across booking flows—profile pages, Cloud Employees, chat, and the API—whenever a specific meeting type is used. See Meeting Types for the full list of rules applied at book time.

Availability Settings

The Availability Settings card defines when you are bookable and which calendars Atonom checks for conflicts. Changes to availability settings save automatically. A brief Saving… indicator appears while updates are in progress. Availability Settings with timezone, selected calendars, and weekly hours grid

Timezone

Select the IANA timezone used to interpret your weekly hours grid (for example, America/New_York or Europe/London). Your painted availability windows are evaluated in this timezone.

Selected calendars

After connecting, Atonom loads the calendars available on your Google or Microsoft account. Use the multiselect to choose which calendars to include.
  • Select All to check every calendar on the account (default on first connect)
  • Select individual calendars to limit availability checks and booking targets
Shared Microsoft calendars require the Calendars.Read.Shared scope. If a user selects a calendar shared with them (rather than one they own), availability checks can fail without this permission. See OAuth & Permissions for details.
If calendars fail to load, try reconnecting your account or confirm the OAuth scopes in the permissions guide.

Weekly hours

Use the weekly hours grid to paint when you are available for meetings:
  • Click or click and drag to mark 30-minute slots as available
  • Scroll the grid for early-morning or late-night hours (full 24-hour day in 30-minute steps)
  • Defaults to Monday–Friday, 9:00 AM–5:00 PM until you change them

Profile page meeting booking (optional)

A profile page is a public page for an individual team member in your organization. Each user can have their own profile page with a shareable link, showing their name, photo, company branding, and optional actions such as Chat with me or meeting booking. Profile pages are separate from Cloud Employee conversations. Visitors who open a profile page link interact directly with that person’s page—not with a Cloud Employee.

Allow visitors to book a meeting with me

If you want visitors to schedule meetings from your profile page:
  1. Go to My Settings → My Profile
  2. Enable Enable my public profile page (if not already on)
  3. Enable Allow visitors to book a meeting with me
  4. Configure which meeting types appear on your profile under Agent Page Meetings — see Meeting Types
This toggle is disabled until a calendar is connected. When enabled, visitors who open your profile page link can pick a meeting type and book a time from your availability.
This setting applies only to booking on your profile page. It does not enable or disable other meeting booking flows, including:
  • Cloud Employees with the meeting booking capability
  • The Schedule a Meeting API
  • Meetings booked on behalf of a user during live chat or voice conversations
You can connect your calendar and configure meeting/availability settings without turning this on. Leave it disabled if you do not want self-service booking on your public profile page.

Troubleshooting

Contact support@atonom.ai if you need assistance.

What’s next

Meeting Types

Create meeting types and configure how they work with calendar booking

OAuth & Permissions

Google and Microsoft scopes, admin setup, and disconnect behavior

Schedule a Meeting API

Book meetings programmatically via the Atonom API

Build Your First Cloud Employee

Enable the meeting booking capability on a Cloud Employee