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.
- Click any Add to Slack button on this site — they all kick off the Slack OAuth flow.
- Pick the workspace you want to install into.
- Review the scopes, then click Allow.
- Slack drops you back into our thank-you page. You're done.
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.
| Scope | Why we need it |
|---|---|
commands | Listen for /calendar slash commands in channels Scalendar has been added to. |
chat:write | Post event cards and reminder messages to those channels. |
channels:read | Read the channel name and ID so the calendar knows where it lives. We never read message history. |
app_mentions:read | Respond when someone @mentions Scalendar — that's the only time we see those messages. |
users:read | Show 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:
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:
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:
| Command | What it does |
|---|---|
/calendar create | Create a calendar in the current channel (channel admins only). |
/calendar add | Open the event-creation Block Kit modal. |
/calendar view | List upcoming events in the channel. |
/calendar view week | Filter the view to this week. |
/calendar view month | Filter the view to this month. |
/calendar help | The 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 → Scalendar → Remove 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.
Add Scalendar to Slack