Docs

Integrations setup

Connect Rostora to the tools your team already lives in. Slack and Google Calendar are Team-tier features — if you're on Free, you'll see upgrade prompts instead of connect buttons.

Workspace-level · Admin only

Slack

Once installed, every Slack user with a matching Rostora account gets the /rostoraslash commands, an interactive Home tab, daily morning posts (opt-in), and Friday reminders.

Before you start

You need to be an admin on the Rostora workspace (not just a Slack admin). The Slack workspace you connect should match where your Rostora team actually works — each Rostora workspace can only be connected to one Slack workspace at a time.

Install

Open Rostora Integrations
Go to www.rostora.com/app/integrations and click Add to Slack.
Authorise the Rostora Slack app
Slack shows the permissions it'll grant: posting messages, opening direct messages, reading user profile and email information to match Slack users to Rostora accounts, and the /rostora command. Click Allow.
Try the slash command
Back in Slack, type /rostorain any channel. You should see a private message with today's team.
(Optional) Turn on the morning post
Run /rostora channel in the channel you want Rostora to post to every weekday at 07:00 UTC. Use /rostora channel off to turn it off.

Daily use

Once installed, Slack users with matching Rostora accounts can drive their schedule from Slack:

See the team
/rostora, /rostora tomorrow, /rostora week.
Set your own schedule
/rostora me remote tomorrow, /rostora me present fri, /rostora me sick today. Accepted days: today, tomorrow, mon–fri.
Use the Home tab
Click Rostorain Slack's left rail. You'll see your whole week with On-site / Remote / Off buttons on every day.
Set your default week
/rostora pattern opens a modal where you pick your usual schedule per weekday. Overrides (set from Home tab or /rostora me) take priority over the pattern.

Troubleshooting

The Home tab says “we couldn't match your email”

Rostora matches Slack users to Rostora accounts by email. If your Slack email and your Rostora email don't match, the Home tab shows a warning instead of your week. Either update your Slack profile email or ask your admin to invite you into Rostora with the email you use in Slack.

Slash command returns nothing / times out

Slack expects a response within 3 seconds. If Rostora is cold-starting this can take longer the first time. Try the command again — subsequent calls should be instant. If it keeps timing out, check your integrations page to confirm Slack is still marked as connected.

Morning post isn't showing up

Morning posts fire at 07:00 UTC on weekdays only, and only to a channel you've set with /rostora channel. Make sure the Rostora bot is a member of that channel (Slack may require you to invite it explicitly). Public holidays in your workspace country don't suppress the post, but empty-team days will look sparse.

“Slack is a Team-tier feature” message

Your workspace is on Free or past the grace period. Admins can upgrade from the billing page. If a workspace downgrades to Free after having Slack installed, commands stop responding until the workspace is back on Team.

I want to reinstall from scratch

Go to Integrations, disconnect Slack, then install again. You'll need to re-run /rostora channel if you use the morning post.

Per-user · Each person connects their own

Google Calendar

Mirrors your Rostora work locations and away days to your personal Google Calendar. Colleagues see your status next to your meetings without leaving Google Calendar.

Before you start

Each user connects their own Google account — there's no admin-wide install. If your company uses Google Workspace with third-party apps restricted, a Workspace admin needs to allow Rostora in the Google admin console first (see troubleshooting below).

Connect

Open Rostora Integrations
Go to www.rostora.com/app/integrations.
Click Connect next to Google Calendar
You'll be redirected to Google's consent screen. Rostora asks for permission to read your email and manage Rostora-created events on your primary calendar only.
Approve and return
Google sends you back to Rostora. You should see a green “Google Calendar connected” banner on the Integrations page.
Check your calendar
Shortly after connecting, upcoming on-site, remote, and partial days appear in Google Calendar as Working Location events (“Office — Floor 3”, “Home”). Sick leave and holidays appear as opaque all-day events. The sync covers the next eight weeks; pattern and override changes re-sync automatically.

What gets synced

Rostora writes upcoming on-site, remote, and partial days as Google Working Location events for the next eight weeks. Sick leave and public holidays sync as opaque all-day events, while Off days are removed from Google Calendar. The sync is one-way— changes you make in Google Calendar don't flow back into Rostora. When you disconnect, existing events stay on your calendar but stop updating.

Troubleshooting

“This app is blocked” from your Google Workspace

Some Workspaces restrict third-party OAuth apps by default. A Google admin needs to Allow Rostora in the Google Admin Console under Security → API controls → Configure third-party app access. Search for the Rostora app in the list, or add its OAuth client ID (available from support).

“Google didn't return a refresh token” error

This happens when Google thinks you've already granted access. Go to your Google permissions page, find Rostora, click Remove Access, then try connecting again. The second-time consent flow issues a fresh refresh token.

Events aren't showing up after connecting

Make sure you're looking at the calendar tied to the Google account you connected (not a shared calendar). Rostora writes to your primary calendar only. When you connect, Rostora backfills the upcoming workdays from your default week and any overrides. If you still see nothing after a minute, check that Google Calendar connections are enabled on your deployment.

Events sync but show as plain all-day entries

The sync is working — Google just isn't rendering the rich Working Location UI because Working hours & locationisn't enabled on your Google account. Enable it once in Google Calendar itself:

Open Google Calendar → settings (⚙️ top-right) → Settings.
In the left sidebar, select Working hours & location.
Tick Enable working hours and pick the weekdays you work.
Leave the per-day location column set to “Unspecified”.Rostora writes the per-day office / home / partial value through the API; setting a default location here competes with what we push and causes the wrong one to win.

On personal (consumer) Gmailaccounts, Working Location rendering is limited — you'll see the full UI on your own calendar, but colleagues viewing your free/busy may only see the event title. On Google Workspace accounts, home-office days show the native home icon; on-site floors use a custom location label that Google may render with a generic pin.

“Main office building” is empty and I can't set it

That's expected and doesn't affect the sync. The buildings dropdown in Google's Working Location settings only has entries if a Google Workspace admin has registered buildings in the Admin Console — personal Gmail accounts never have any. Rostora pushes a free-form label (e.g. “Floor 2”) on each event, which Google renders as the location text regardless of whether a building is configured.

I want to see the Rostora schedule as a shared calendar

Not supported today. Each user mirrors to their own calendar. A team-level shared calendar is on the roadmap — let us know if this blocks you, it helps prioritise.

“Google Calendar is a Team-tier feature” message

Your workspace is on Free or past the grace period. Ask your workspace admin to upgrade from the billing page. Individual users can't upgrade — only admins.

Still stuck?

Email support@rostora.com — we typically reply within 1–2 business days.

Integrations setup

Connect Rostora to the tools your team already lives in. Slack and Google Calendar are Team-tier features — if you're on Free, you'll see upgrade prompts instead of connect buttons.

Workspace-level · Admin only

Slack

Once installed, every Slack user with a matching Rostora account gets the /rostoraslash commands, an interactive Home tab, daily morning posts (opt-in), and Friday reminders.

Before you start

Install

Open Rostora Integrations
Go to www.rostora.com/app/integrations and click Add to Slack.
Authorise the Rostora Slack app
Slack shows the permissions it'll grant: posting messages, opening direct messages, reading user profile and email information to match Slack users to Rostora accounts, and the /rostora command. Click Allow.
Try the slash command
Back in Slack, type /rostorain any channel. You should see a private message with today's team.
(Optional) Turn on the morning post
Run /rostora channel in the channel you want Rostora to post to every weekday at 07:00 UTC. Use /rostora channel off to turn it off.

Daily use

Once installed, Slack users with matching Rostora accounts can drive their schedule from Slack:

See the team
/rostora, /rostora tomorrow, /rostora week.
Set your own schedule
/rostora me remote tomorrow, /rostora me present fri, /rostora me sick today. Accepted days: today, tomorrow, mon–fri.
Use the Home tab
Click Rostorain Slack's left rail. You'll see your whole week with On-site / Remote / Off buttons on every day.
Set your default week
/rostora pattern opens a modal where you pick your usual schedule per weekday. Overrides (set from Home tab or /rostora me) take priority over the pattern.

Troubleshooting

The Home tab says “we couldn't match your email”

Slash command returns nothing / times out

Morning post isn't showing up

“Slack is a Team-tier feature” message

I want to reinstall from scratch

Go to Integrations, disconnect Slack, then install again. You'll need to re-run /rostora channel if you use the morning post.

Per-user · Each person connects their own

Google Calendar

Mirrors your Rostora work locations and away days to your personal Google Calendar. Colleagues see your status next to your meetings without leaving Google Calendar.

Before you start

Connect

Open Rostora Integrations
Go to www.rostora.com/app/integrations.
Click Connect next to Google Calendar
You'll be redirected to Google's consent screen. Rostora asks for permission to read your email and manage Rostora-created events on your primary calendar only.
Approve and return
Google sends you back to Rostora. You should see a green “Google Calendar connected” banner on the Integrations page.
Check your calendar
Shortly after connecting, upcoming on-site, remote, and partial days appear in Google Calendar as Working Location events (“Office — Floor 3”, “Home”). Sick leave and holidays appear as opaque all-day events. The sync covers the next eight weeks; pattern and override changes re-sync automatically.

What gets synced

Troubleshooting

“This app is blocked” from your Google Workspace

“Google didn't return a refresh token” error

Events aren't showing up after connecting

Events sync but show as plain all-day entries

The sync is working — Google just isn't rendering the rich Working Location UI because Working hours & locationisn't enabled on your Google account. Enable it once in Google Calendar itself:

Open Google Calendar → settings (⚙️ top-right) → Settings.
In the left sidebar, select Working hours & location.
Tick Enable working hours and pick the weekdays you work.
Leave the per-day location column set to “Unspecified”.Rostora writes the per-day office / home / partial value through the API; setting a default location here competes with what we push and causes the wrong one to win.

“Main office building” is empty and I can't set it

I want to see the Rostora schedule as a shared calendar

Not supported today. Each user mirrors to their own calendar. A team-level shared calendar is on the roadmap — let us know if this blocks you, it helps prioritise.

“Google Calendar is a Team-tier feature” message

Your workspace is on Free or past the grace period. Ask your workspace admin to upgrade from the billing page. Individual users can't upgrade — only admins.

Still stuck?

Email support@rostora.com — we typically reply within 1–2 business days.