Manual

Commands

/create

Create an event
Creates an event in the server. Users will be able to RSVP to the event, and opt into reminders via DM. When the event starts, an event starting message will be sent to the channel the event was created in.

Once the event is created, users can click the ⚙️ button in order to manage their RSVP, view all attendees, or modify (edit/delete) the event. Only server
adminsUsers with Manage Server permissions
admins
or the creator of the event can modify the event.

Alternatively, you can create an event using the web interface. Use the web interface for advanced features such as repeat events, signup options, colors, and more. The event listings page on the web interface also provides a way to add and remove RSVPers from the event.

Parameters
title
The title of the event. Limited to 64 characters.
datetime
The time and date for the event. Must be in the future. Times will be parsed using the server's timezone.

in 5 hours

8pm on Friday

08/21 at 19:30

tomorrow at 5pm

/poll

Create a poll
Creates a poll in the server. Users in the channel will be able to vote on the poll. Results will be displayed in real time.

Once the poll is created, users can click the ⚙️ button to manage their vote(s), view graphs, or modify (edit/delete) the poll. Only server
adminsUsers with Manage Server permissions
admins
or the creator of the event can modify the poll.

Alternatively, you can create a poll using the web interface. Use the web interface for advanced features such as time-based poll options, setting a poll end time, customizing the embed color, voting restrictions, and more. You can also view and manage all polls in a server on the poll listings page.

Parameters
title
The title of the poll. Limited to 252 characters.
options
The options that users will vote on. Each individual option should be separated by a comma.
Limited to 15 total options, with each option limited to 250 characters.

Cats, Dogs, Giraffes

Blue, Orange, Red, Green, Brown

Monday, Tuesday, Wednesday

/settings

View and modify sesh settings
Gives a brief overview of current sesh settings for the current server. Settings include default signup options for events, event and poll channels, custom command permissions, and more.

Users can click the Modify Server Settings button in order to edit the settings. Though everyone in the server can view the current settings, only
adminsUsers with Manage Server permissions
admins
can modify them. Users can also reach the server settings page by going to the web interface directly.

This command can also be used in DMs with sesh to view and modify your personal sesh settings.

/link

Create an importable calendar feed of events
Generates a calendar feed URL that you can add to Google Calendar or other calendar applications (ICS format). The feed will contain all events in the server viewable by the user who ran the command. See the channels parameter below for filtering options.

Users can also generate a personal events feed by clicking the 📅 button. This feed will only contain events that the user has RSVPed to.

If the server has Use Separate Channel Calendars enabled, the feed will only contain events in the channel the command is run in.

Server
adminsUsers with Manage Server permissions
admins
can reset all event feeds on the server settings page. This will remove all current server feeds (except personal feeds) and require a new feed to be generated by running the /link command again. Any users who wish to continue receiving the events feed will have to resubscribe to the new feed.

Parameters

/list

List events
Shows all ongoing and future events in the server. Times will be displayed in the server's primary timezone. Users can click the 🕐 button in order to display the list in their own timezone. Use the optional parameters below to filter which events are shown.

Clicking the 🔄 button will turn the list into a live list. Live lists are constantly updated in order to display all events in real time. Live lists also support pinning to the bottom of the channel via the 📍 button.

If the server has Use Separate Channel Calendars enabled, the list will only contain events in the channel the command is run in.

This command can also be used in DMs with sesh to see a list of all the events you have RSVPed to.

Parameters

/remind

Create a one-off reminder
Create a simple one-off reminder. The user who runs the command will receive a DM at the specified time. Other users can subscribe to the reminder by clicking the 🔔 button.

DMs from sesh must be enabled in order to receive reminders.

Parameters
title
The title of the reminder.
datetime
The time and date for the reminder. Must be in the future.

in 5 hours

8pm on Friday

08/21 at 19:30

tomorrow at 5pm

/delete

Delete sesh events
Delete one or more events in the server. The command will first show a list of events matching your query, then you can confirm which of them you would like to delete.

Server
adminsUsers with Manage Server permissions
admins
can delete any events in the server, whereas non-admins can only delete events they have made.

For a full list of deletable events, use the event listings page on the web interface.

Parameters

/premium

View or activate sesh premium features
Shows info related to sesh premium. Premium members can click the ✨ Activate button in order to enable premium features on their server.

This command can also be used in DMs with sesh in order to manage all of your activations.

/dashboard

View the web interface for this server
Responds with an embed that contains links to all the major sesh dashboard pages.

Parameters

/votepoints

Get vote points by voting for sesh on top.gg
Shows your current vote points and links to the sesh vote page on top.gg. Voting for sesh helps spread the word and we greatly appreciate it. You can also use vote points to activate and extend live lists.

Advanced Features

Discord Native Events
You can mirror sesh events to Discord's new native events feature. Just check the "Mirror to Discord Native Event" box on the Create Event page.

Alternatively, you can enable mirroring for every event on your server settings page.

Discord native events will appear prominently in your server. Event listings will appear above your channel list, and a badge is shown on your server icon while the event is live.

When a sesh event is mirrored to a Discord native event, any changes to one will be applied to the other. For example if you rename the native event, the sesh event will also be renamed (and vice-versa).

For sesh to recognize RSVPs, users must signup via the sesh event message, and not the built-in Discord event viewer. The signup message will always be linked to in the description of the native event.

Note that native events will be visible to everyone in the server unless a voice channel is set, in which case the event will only be visible to those with access to the voice channel.

Location Field

Discord native events have a customizable location field. The location appears in multiple places around your native Discord event.

You can choose one of three options for customizing the Discord native event location.

  • Event Signup Link - The location will be set to a link to the sesh signup message for the event.

  • Voice Channel - The voice channel for the event. When the event starts, the voice channel will be visually highlighted in Discord. Only users with access to the voice channel will be able to see the native event.

  • Stage Channel - The stage channel for the event. When the event starts, the stage channel will be visually highlighted in Discord. This option is only available if there is a Stage Channel present in the server.

  • Somewhere Else - Any text you want, limited to 100 characters.

Google Calendar Sync

Use Google Calendar? sesh supports full two-way sync with direct Google Calendar API integration for speedy syncing. Just type /link in your server to get started.


Alternatively, you can navigate to your server's settings page on the dashboard and go to the Sync tab.


Once you authenticate with Google, you'll be able to select which direction you'd like to sync your events in:



You'll also be able to configure some additional settings, such as which events to include, which Google Calendar to sync to, and more.


Activating a server with premium membership unlocks the following benefits for Google Calendar sync (for all users on your server):


  • Unlocks Inbound and Bidirectional syncs (5 per user, per server)
  • Increases limit of Outbound syncs to 5 (default 1 per user, per server)

Known Issues and Limitations


Note that Google Calendar sync is still in beta. There are a few known issues we're working on, including:


  • Recurring events: Hourly repeat events are not supported by Google Calendar and will not sync
  • Recurring events: Editing or deleting single instances of the event in Google Calendar is not yet fully supported
  • You may need to setup your sync again in case of a permissions or API error. In the future sesh will automatically resume syncing when errors are resolved.

We're also planning to add some more sync features soon, including:


  • Discord native event support