Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cakeday.io/llms.txt

Use this file to discover all available pages before exploring further.

Cake Day is built around a simple idea: celebrations should happen automatically, and teammates should control their own data. Once it’s installed and configured, the only thing your team needs to do is opt in. Everything else runs on its own. Here’s the full flow, from install to shoutout.
1

Install

A workspace admin installs Cake Day via OAuth from cakeday.io or the Slack App Directory. During authorization, Slack grants Cake Day the scopes it needs to post messages, read channel lists, send DMs, and run the /cakeday slash command. After install, the admin is redirected to the setup wizard at cakeday.io/app/onboarding.
2

Configure

The admin sets three things:
  • Celebration channel — where shoutouts get posted.
  • Post time — the time of day (in your timezone) when the daily check runs.
  • Timezone — used to ensure the check fires at the right local time.
These settings live at cakeday.io/app/settings and can also be accessed with /cakeday setup in Slack.
3

Members opt in

Each teammate joins the roster on their own terms. They can:
  • Run /cakeday me in Slack to open a modal and enter their birthday and/or work start date.
  • Click Add my dates in a DM invite sent by an admin (via /cakeday invite @teammate or a bulk broadcast from the dashboard).
Admins never manage a spreadsheet. They can see who’s on the roster and who’s pending from the Roster page at cakeday.io/app/roster, but the dates themselves are entered by each person.
4

Daily check

Every day at the configured post time, Cake Day scans the roster for anyone whose birthday or work anniversary falls on today’s date — adjusted for the workspace’s timezone. Only active workspace members are included in the check.
Cake Day never posts a shoutout for someone who has left the workspace. Before generating a message, it verifies that the person is still an active member of your Slack workspace.
5

Shoutout generation and posting

For each match, Cake Day:
  1. Sends a minimal context to Google Gemini — the person’s display name, the type of celebration (birthday or anniversary), and for anniversaries, the year count.
  2. Gemini generates a personalized message. Pro plan workspaces can customize the AI’s tone with a prompt set in cakeday.io/app/settings.
  3. Cake Day pairs the message with a curated GIF and posts it in the celebration channel, tagging the person.
Each celebration counts as one toward the workspace’s annual cap.
6

Cap tracking

Cake Day tracks how many celebrations your workspace has sent since the billing period started (anchored to your install date). When you reach 80% of your plan’s annual cap, admins receive a DM heads-up. If the cap is hit, the celebration is skipped — the bot notifies admins and logs the skipped event, but does not post publicly.Admins can check current usage at any time by running /cakeday usage in Slack or visiting the billing page at cakeday.io/app/billing.