WhenToMeetWhenToMeet

Discord Integration

The WhenToMeet Discord bot lets you create availability polls and share events directly in your Discord server. Participants vote on time slots using buttons, and results sync back to WhenToMeet in real time.

Add the bot to your server →

Setup

  1. Invite the bot — visit whentomeet.io/discord to add the bot to your server.
  2. The bot registers a single /meet slash command with three subcommands: share, poll, and link.

Before you can share events, link your Discord account to your WhenToMeet profile:

  1. Send a DM to the bot with /meet link. This only works in a direct message, not in a server channel.
  2. The bot replies with a one-time link valid for 15 minutes.
  3. Open the link in your browser. If you are not signed in to WhenToMeet, you will be asked to sign in first.
  4. Confirm the link on the web page. Your Discord account is now connected to your WhenToMeet profile.

Once linked, your Discord votes appear under your WhenToMeet profile instead of just your Discord username.

Share an event

Post an existing WhenToMeet event to a Discord channel so participants can vote on time slots:

/meet share
  • Select the event from the dropdown (shows your organized events).
  • The bot posts an embed with the event title and a button for each time slot.
  • Participants click a slot button to toggle their availability (green = available, click again to remove).
  • Votes sync to the WhenToMeet event page in real time.

Create a quick poll

Run a quick availability poll without leaving Discord:

/meet poll
  1. Enter a title for your poll (e.g. "Game night this Friday?").
  2. A modal opens where you can add time slots and select a timezone.
  3. Review the confirmation preview showing all slots.
  4. The bot posts the poll with a button per time slot.
  5. Participants click buttons to toggle their vote for each slot.

Polls close automatically after 24 hours, and the bot updates the message with final results.

How voting works

  • Each time slot has its own button. Click to vote available, click again to remove your vote.
  • You can vote on multiple slots — select all that work for you.
  • The embed updates in real time to show who voted for each slot.
  • If your Discord account is linked to WhenToMeet, your vote is attributed to your WhenToMeet profile.

FAQ

Can I use the bot without linking my account?

Yes. You can vote on polls and shared events without linking. Your votes will appear under your Discord username. Linking is only required to share events and to have votes attributed to your WhenToMeet profile.

What permissions does the bot need?

The bot needs these permissions:

  • Send Messages — to post polls and event shares
  • Read Message History — to update existing poll messages
  • Use External Emojis — for status indicators on buttons

Can I close a poll early?

Not yet. Polls close automatically after 24 hours. This may be added in a future update.

Where can I get help?

If you run into issues, visit the WhenToMeet documentation or reach out through the app's support channels.

Was this page helpful?