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


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 |
|
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 |
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..


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.


Users notified