Google Calendar Integration
Connect your own Google account from your profile and create Google Calendar events, with a Google Meet link and invited attendees, using the /schedule command in chat.
Overview
The Google Calendar integration lets you create events on your own Google Calendar without leaving the app. You connect your Google account once from your profile; after that, typing a /schedule command in any chat creates the event, attaches a Google Meet link, and posts a confirmation in the chat for everyone in it.
The connection is per user, not per organization. Each person connects their own Google account, and events are created on that person's primary calendar.
The integration only appears when it is enabled for your organization. If the Google Calendar card is missing from your profile, the feature is not switched on for your organization; contact support.
How To
Connect your Google account
- Open your profile from the avatar menu (Profile).
- In the Google Calendar card, click Connect Google Calendar.
- Sign in to Google and approve access. The app asks for permission to manage your calendar and events and to read your email address.
- You are returned to your profile with the message "Google Calendar connected successfully!" and the card shows a Connected badge with the Google email address.
Tokens are stored encrypted and refreshed automatically when they expire. Reconnecting replaces the stored tokens for your account.
Check connection status
The Google Calendar card on your profile shows one of two states:
| State | What you see |
|---|---|
| Connected | A green Connected badge, the Google email, the /schedule syntax, and Disconnect Google Calendar |
| Not connected | A short description and Connect Google Calendar |
Create an event from chat
In any chat, send a message that starts with /schedule. The chat input offers /schedule as a slash command with a pre-filled template for a 30-minute meeting starting now in your time zone.
Format:
| Part | Accepted values |
|---|---|
| title | In quotes if it contains spaces; otherwise the first word |
| date | YYYY-MM-DD, MM/DD/YYYY, today or tomorrow |
| time | 24-hour 14:30 or 12-hour 2:30pm, 2pm |
| duration | Minutes (60), or with a unit (1h, 30m) |
| attendees | Optional. Comma-separated email addresses, no spaces |
| timezone | Optional, last. An IANA name such as America/Chicago, or UTC. Defaults to America/New_York |
Examples:
What happens:
- The event is created on your primary Google Calendar with the title, start and end times, and any attendees.
- A Google Meet conference is attached.
- Google emails invitations to the attendees.
- Your chat message is replaced with a confirmation card showing the title, the time range in the event's time zone, the attendee list, and a Join Google Meet button.
If the command fails, the chat message is replaced with "Failed to create calendar event" and the reason, for example an unsupported date format or that your calendar is not connected. Nothing is created in that case.
Disconnect
- On your profile, click Disconnect Google Calendar.
- Confirm the browser prompt "Are you sure you want to disconnect Google Calendar?".
The app revokes its access with Google and marks the connection inactive. Events already on your calendar are not removed. You can reconnect at any time.
Tips
- Use the slash command picker in the chat input rather than typing from memory; it fills in today's date, the current time and your time zone.
- Put the time zone at the end when the people in the chat are not all in Eastern time. Without it, the event time is read as
America/New_York. - Attendees get a Google invitation by email, so the confirmation in chat plus the invite is usually enough; no separate message is needed.
- Each coach connects their own account. A booking or session in Connected Performance does not create a calendar event by itself; only
/scheduledoes.
Troubleshooting
The Google Calendar card is not on my profile. The feature is not enabled for your organization. Contact support.
"Google Calendar not connected" in the chat error. Connect your account from your profile, then send the command again. Chat posts the event on behalf of whoever typed the command.
"Failed to create calendar event: Unsupported date format".
Use YYYY-MM-DD, MM/DD/YYYY, today or tomorrow. The same error for time means the time was not HH:MM, H:MMam/pm or Ham/pm.
"Missing required fields: date, time, duration". All three are required, in that order, after the title. If the title has spaces, wrap it in quotes.
"Missing closing quote for title". The title started with a quote but never ended with one.
"Failed to initiate Google connection". The app could not start the Google sign-in. Try again; if it persists, contact support.
The event was created at the wrong hour.
No time zone was given, so the time was interpreted in America/New_York. Add your IANA time zone as the last part of the command.
Google says the account was disconnected but the badge still says Connected. The app only knows what it stored. Click Disconnect Google Calendar, then Connect Google Calendar to re-authorize.
Related
- Chat
- Your Account & Profile
- Sessions & Availability
Referenced by
- 'Managing Coaches'user management