Events let you organize and respond to gatherings in the real world with people on your app.

1280 — Here is what an event can look like

Event object structure

Event

property	type	description
name	String	Event name
description	String	Event description
is_cancelled	Boolean	Event is cancelled?
max_seats	Int	Max people that can join the event
free_seats	Int	Remaining seats
taken_seats	Int	Taken seats
total_members	Int	Total members (waiting people included)
start_date	Date	ISO8601 event starting date
end_date	Date	ISO8601 event ending date
members	List	See below
event_member_access_control	Enum	`PUBLIC` or `FRIEND_OF_FRIEND`
location	Location	Meeting location point
is_member	Boolean	Tell if the current user doing the request is member of this event
is_available	Boolean	Is the event still available to be joined ?
static_maps_url	String	URL with a server side generated Google Static Map image
distance_in_meters	Int	Approximate distance in meters from the current User location to this Event. User location can be set by using `latitude` and `longitude` while listing events. Otherwise, `user.living_location` is used.
profile_photo	Photo	Main image. JPG, PNG, GIF accepted.
profile_cover_photo	Photo	Secondary image. JPG, PNG, GIF accepted.
remaining_seconds_before_start	Long	Remaining seconds before starting date
custom_fields	List	Collection of Event custom fields

EventMember

Represent the current and previous status of each member

property	type	description
created_date	Date	ISO8601 date when the member first join the event
updated_date	Date	ISO8601 date when the member had his status updated
user	User	Event member user
event	Event	Event
status	Enum	Current status from the member
previous_status	Enum	Previous status from the member

Status Enum

property	description
WANT_TO_PARTICIPATE	Person who indicates that he wishes to participate
WAITING_CONFIRMATION	48 hours before the start of the event, the member receives a notification and must confirm his / her final presence
CONFIRMED	Member who has confirmed his participation
WAITING_FOR_FREE_SEAT	Member waiting for an available seat
NO_RESPONSE	No response from this member, he will not participate
NOT_AVAILABLE	Member who has indicated that he will not participate
HAS_CANCELLED	Member who canceled his participation after indicating that he was participating
HAS_CANCELLED_AFTER_HAVING_CONFIRMED	Member who canceled his participation after confirming his participation

Each event makes it possible to manage the list of its participants and to ask them for confirmation of participation 48 hours before the event. This is done automatically. Management of users waiting for a place available is also available. More info below..

842 — Here is the complete workflow for an event

842 — Here is the complete workflow for an event

Geo-Localized Events

A user (ADMIN or ALL) can organize an event and notify all users in the surrounding area. These are geo-localized events. The notification distance is configurable by each user from their profile e.g: Do you want to organize a picnic in 4 days? It's easy and your friends are invited automatically.