Skip to content

Docs

Everything Scalendar can do, written down.

Five-minute install. Two-minute first event. The rest of these docs are for when you want to do something specific.

Install Scalendar

You'll need to be a Slack workspace admin or owner to install Scalendar. The install takes about 30 seconds and asks for a minimal set of OAuth scopes — listed in plain English below.

  1. Click any Add to Slack button on this site — they all kick off the Slack OAuth flow.
  2. Pick the workspace you want to install into.
  3. Review the scopes, then click Allow.
  4. Slack drops you back into our thank-you page. You're done.
Not an admin?Slack will let you "request" the install. Your admin gets a tidy little notification with a one-click approve button. You can also email them directly from the install confirmation screen.

Scopes we ask for

Slack will show you this list before you approve. Here it is up front, no surprises — five scopes, each tied to one specific thing Scalendar needs to do.

ScopeWhy we need it
commandsListen for /calendar slash commands in channels Scalendar has been added to.
chat:writePost event cards and reminder messages to those channels.
channels:readRead the channel name and ID so the calendar knows where it lives. We never read message history.
app_mentions:readRespond when someone @mentions Scalendar — that's the only time we see those messages.
users:readShow event creator display names. We never read emails, phone numbers, or other profile fields.

For the long-form legal version, see our privacy policy.

Your first calendar

Calendars live inside Slack channels. Open the channel you want to give a calendar — say #team-launchpad — and run:

/calendar create

Scalendar pops a modal asking who can add events. Pick one:

  • View only — channel members can view events; only admins can add them.
  • Open — anyone in the channel can view and add.

Hit Create calendar. Scalendar posts a confirmation message in the channel and you're off.

Adding your first event

In any channel with a calendar, run:

/calendar add

Five fields:

  • Title — what is it?
  • Date & time — when does it start?
  • Duration / end — how long?
  • Description — optional, but nice for context.
  • Reminder — when to ping the channel.

Submit. Event lands in the channel as a Block Kit card and is added to your channel calendar. Done.

Slash commands

Everything Scalendar can do, from the keyboard:

CommandWhat it does
/calendar createCreate a calendar in the current channel (channel admins only).
/calendar addOpen the event-creation Block Kit modal.
/calendar viewList upcoming events in the channel.
/calendar view weekFilter the view to this week.
/calendar view monthFilter the view to this month.
/calendar helpThe commands list, but inside Slack.

Permissions

Two layers — channel and event.

Channel-level

  • Channel owners and admins can create, configure, and delete the calendar.
  • All members can always view events.
  • Adding events depends on the calendar's permission mode (View-only vs Open).

Event-level

  • Event creators can edit and delete their own events.
  • Calendar admins can edit and delete any event.

Reminders

Reminders fire as a channel message before an event starts. On Free, every calendar uses a fixed 15-minute lead. On Premium and up, you can also:

  • Change the default lead time for an entire calendar.
  • Override per-event with custom timing (e.g. 1 day before).
  • Stack multiple reminders on a single event, each with its own timing.
  • Direct-message the reminder to specific users instead of (or in addition to) the channel.

App Home tab

Click Scalendar in your Slack sidebar to open the Home tab. It shows:

  • Every calendar you have access to, grouped by channel.
  • Your next seven days, sorted, with one-click jump into any event.
  • Your current plan and calendar usage.

Plans & billing

See the full breakdown on the pricing page. Billing is per workspace, monthly, via Stripe. Annual billing saves 20%.

Uninstalling

Open Apps in your Slack workspace settings → ScalendarRemove app. Your calendars and events are retained for 30 days in case you change your mind, then permanently deleted.

Security

  • OAuth tokens encrypted at rest (AES-256).
  • HTTPS everywhere. TLS 1.2 or higher.
  • Slack request signatures verified on every webhook (HMAC-SHA256).
  • Just-in-time database access for engineers, with full audit logs.

For the full security write-up — infrastructure, access controls, compliance — see the privacy policy.

FAQ

Can Scalendar read my channel messages?

No. We only see slash commands typed at /calendar and events you explicitly create. Regular channel messages are never visible to Scalendar.

Will it work in private channels?

Yes — provided Scalendar has been added to the channel. Slack gates that; we just do calendars.

Can I export to Google Calendar or Outlook?

iCal export is on our roadmap. Two-way sync with Google and Outlook is the release after that.

Do you support multiple Slack workspaces?

Yes — install Scalendar separately in each workspace. Billing and calendars are scoped per workspace.

Get support

Free plan: email hello@scalendar.app. We aim for a 48-hour first response.

Premium and Enterprise: priority queue with a 24-hour SLA, plus a dedicated Slack Connect channel on Enterprise.

Ready to stop reading and start scheduling?

The fastest way through these docs is to install Scalendar and try the commands yourself.

Join waitlist