How to connect Google Calendar to Asa.Team

Connect Google Calendar and Asa adds your approved leave to your own calendar as all-day events, so your calendar shows when you are away. Each person connects their own Google account. It is not a company-wide switch.

Google Calendar is separate from the chat apps. See Chat apps and integrations for the others.

What syncs

Asa copies one kind of thing to Google Calendar: your own leave, once it is approved. Nothing is copied back.

Item	Syncs to Google Calendar
Your leave after an admin or team lead approves it	Yes, as an all-day event
An approved leave cancellation	Yes, the event is deleted
Leave that is still pending, or was rejected	No
Leave that Asa approved automatically, because the leave type needs no approval	No
Leave approved before you connected, or while the connection was broken	No
Public holidays	No
Anyone else’s leave	No
Changes you make in Google Calendar	Never copied back to Asa

The Calendar card says “Keep approved leave and holidays in sync with your calendar.” Only approved leave is synced today. Holidays are not added to Google Calendar. See Request and approve time off for how leave is requested and approved, and Calendar for the holidays and leave you see in Asa.

When you connect, Asa creates a calendar named Asa Leaves in your Google account with the description “Leave and time off events synced from Asa.Team”, and puts the events there. If you already have a calendar with that name, Asa reuses it. Each event:

• is titled with the leave type and your name, for example “Annual leave - Alex Tan”,
• covers the whole days of the leave and shows you as busy,
• has your reason as its description, or the leave type and the number of days when you gave none,
• uses a colour that matches the leave type.

Asa asks Google only for permission to create its own calendar and manage events on it, and to see your email address.

Connect Google Calendar

Any member can connect. You do not need to be an admin.

1. Open Company in the sidebar, then Integrations.
2. Find the Calendar card below the chat app tabs. It shows Google Calendar with “Sync approved leave to your calendar”.
3. Select Connect. Google opens.
4. Choose your Google account and allow access.

You land on a page that says Google Calendar Connected! and “Your approved leave requests will now automatically sync to your Google Calendar.” Select Go to Integration Settings to go back. The card now shows a Connected badge and a Disconnect button.

Connecting again replaces your earlier connection. You have one Google Calendar connection at a time.

Leave that was approved before you connected is not added afterwards. Only leave approved from now on appears on your calendar.

If connecting fails

The page shows Connection Failed with a reason. Select Try Again to return to Integrations.

Message	What to do
“You denied access to Google Calendar. Please try again if you want to connect your calendar.”	Select Connect again and allow access.
“Google returned an error:” followed by a code	Select Try Again. If it repeats, contact support.
“Missing required parameters. Please try connecting again.”	Start again from Connect.
“Failed to connect Google Calendar”	Try again in a few minutes.

Back on the Integrations tab, “Failed to start connection” or “Failed to connect” means Asa could not reach Google. Select Connect again.

Fix a connection that stopped syncing

If an approved leave does not show up in Google Calendar, the connection may be broken. Asa shows Connected whenever it holds your saved connection, and it does not check with Google again, so the card cannot tell you the connection has gone stale. Common causes are removing Asa’s access in your Google account, or deleting the Asa Leaves calendar.

1. Open Company > Integrations.
2. On the Calendar card, select Disconnect.
3. Confirm with Disconnect in the dialog “Disconnect Google Calendar from your Asa account?”. Asa says “Disconnected from Google Calendar”.
4. Select Connect and allow access again.

Asa creates a fresh Asa Leaves calendar if the old one is gone. Leave that was approved while the connection was broken is not sent again, so add those days to your calendar by hand.

Also check that the leave was actually approved. Pending leave never syncs, and neither does leave that was approved automatically. See Leave policies for which leave types need approval.

Disconnect Google Calendar

1. Open Company > Integrations.
2. On the Calendar card, select Disconnect.
3. Confirm Disconnect.

Asa stops adding events. The Asa Leaves calendar and the events already in it stay in your Google account. Delete them in Google Calendar if you no longer want them. If you cancel an approved leave after disconnecting, its old event is not removed for you.