# Events

> The community's calendar, with online, in-person or hybrid events, an address on the map, RSVPs, live streaming via YouTube, Vimeo or Mux, email reminders and ticket sales.

The **Events** module organizes the calendar: live sessions, workshops, mentoring sessions, in-person meetups, conferences. Each event has its own page with the date, location, hosts, who's going and, if it's online, the stream.

## What it's for

| Community | Events |
|---|---|
| Online school | The weekly Q&A live session, streamed on YouTube |
| Coworking | The monthly happy hour, in person, with the address on the map |
| Company HR | New employee onboarding, hybrid |
| Association | The annual conference, with tickets for sale |

## How it works

### The event

| Field | What it's for |
|---|---|
| **Event Title**, **Description** | What it is |
| **Event Type** | Livestream, Workshop, Webinar, Meetup, Mentorship, Conference, Masterclass, Bootcamp, Networking, Panel, Round Table, Pitch, Demo Day, Ask Me Anything and others |
| **Target Audience** | Who it's for |
| **Event Format** | **Online**, **In Person** or **Hybrid** |
| **Event Location** | For in-person and hybrid: the address, searched on the map (*"Location is required for in-person events"*) |
| Start and end **date and time** | When |
| **Main Image (16:9)** and **Featured Image (1:1)** | 2000×1125 px and 800×800 px recommended |
| **Visibility** | **Public**, **Members Only** or **Private** |
| **Organizers** and **Hosts** | Who organizes and who presents |

### RSVPs

On the event page, each member responds and is marked as **Registered**, **Interested** or **Not Attending**. The staff sees the list of attendees. After the event, the page shows *"This event has ended"* and, for each attendee, *"You attended this event"*.

### Live streaming

For online events, the organizer opens **Manage Stream**:

1. Chooses the **Streaming Platform**: **YouTube**, **Vimeo** or **Mux**.
2. Pastes the **Stream URL** (on YouTube, the link or the video ID).
3. **Save URL**, to have it ready, or **Save and Start**, when the live session is already on air.

Once the stream has started, the page shows *"Streaming now"* and **Watch Live**, and members watch right there. **Stop Stream** ends it.

### Emails

| When | Email |
|---|---|
| A member RSVPs | Registration confirmed |
| **1 hour before** it starts | Reminder |
| The stream starts | Notice that it's live |
| The event is canceled | Cancellation |

### Lists

The space separates **Upcoming** and **Past** and highlights the **Featured Event**. Events also show up in the [Feed](/espacos/feed).

### Who can do what

| Action | Who |
|---|---|
| Create and edit an event | Moderator, admin and owner (and the space's **Who can post**) |
| Start and stop the stream | Moderator, admin and owner |
| Delete an event | Admin and owner |
| RSVP | Members with access to the space |

## Step by step

### Create an event

*Role: moderator, admin or owner.*

1. In the Events space, **Create Event**.
2. **Event Title**, **Description**, **Event Type** and **Target Audience**.
3. **Event Format**; for in-person or hybrid, **Search address...** and pick the location.
4. **Start Date**, **Start Time**, **End Date**, **End Time**.
5. The images.
6. **Visibility**, **Organizers** and **Hosts**.
7. **Create Event**.

### Delete

*Role: admin or owner.*

In the event's menu, **Delete event**, then tick *"I confirm I want to delete this event"*. Attendees and comments go with it.

## Selling tickets

1. Create a one-time [product](/monetizacao/produtos) (the ticket), with **Control Stock?** for the number of places.
2. Set the event's space to **Private**, with the product under **Who gets in › Products**.
3. Whoever buys gets into the space and RSVPs to the event.

The RSVP is still done by the person: buying the ticket unlocks the space; it doesn't register them automatically.

## Examples

**A weekly live session.** A **Live sessions** space (Members, **Staff**). Every Tuesday, an Online event of type Livestream, with the YouTube URL saved beforehand and **Save and Start** at showtime.

**The coworking happy hour.** An In Person event with the house's address; residents RSVP and get the reminder 1 hour before.

## Common errors and how to fix them

| Situation | What to do |
|---|---|
| *Location is required for in-person events* | Search for and pick the address |
| *Address not found. Try refining your search.* | Include the number and the city |
| A member doesn't see **Create Event** | Creating events is for moderators and above |
| The stream doesn't appear | The live session isn't active on the platform yet, or **Save and Start** was skipped |

## Frequently asked questions

**Can I repeat an event every week?**
There's no recurrence: create one event per date.

**Does live chat work?**
Stream chat is on its way (*"Chat coming soon"*); for now, the conversation happens in the comments.

## In the API

`POST /api/events` (`spaceId`, `title`, `slug`, `type`, `startTime`, `endTime`, address, `streamingUrl`, `streamingService`), `PUT /api/events/{id}`, `POST /api/events/{id}/participate`, `GET /api/events/{id}/participants`, `POST /api/events/{id}/start-stream` and `stop-stream`. See [Events](/api/referencia/events).

## Related

- [Feed](/espacos/feed)
- [Products](/monetizacao/produtos)
- [Platform emails](/notificacoes/emails-da-plataforma)