Event

Path /{event-id}

Represents a event object of a Workplace community or group.

Reading

You can read information about a single Event by making a Graph API GET request to /{event-id}.

Permissions

Reading information about events requires the Read group content permission.

Fields

Field NameDescriptionType

id

The id of this event.

string

attending_count

Number of people attending the event.

int32

cover

Cover picture.

url

declined_count

Number of people who declined the event.

int32

description

Long-form description.

string

end_time

End time, if one has been set.

datetime

event_times

Array of times of a multi-instance event.

List<datetine>

guest_list_enabled

Can see guest list.

bool

interested_count

Number of people interested in the event.

int32

is_canceled

Whether or not the event has been marked as canceled.

bool

maybe_count

Number of people who maybe going to the event.

int32

name

Event name.

string

owner

The profile that created the event.

Member

parent_group

The group the event belongs to.

Group

place

Event Place information.

string

start_time

Start time.

datetime

timezone

Timezone.

enum

type

The type of the event.

enum {private, public, group, community}

updated_time

Updated time.

datetime

Publishing

You can't publish using this edge. In order to create an event, publish to the /{group-id}/events edge. Publishing requires Manage group content permission.

Fields

Field NameDescriptionType

description

Description of the event.

string

end_time

End time of the event in ISO format.

datetime

location

Location of the Event.

string

name

Name of the event.

string

start_time

Start time of the event in ISO format, can omit time and only include date information.

datetime

Deleting

You can delete an event by making a Graph API DELETE request to /{event-id}.

Updating

You can't update using this node.

Edges

Edge NameDescription

/admins

Users that are admins of the event.

/attending

Users attending the event.

/interested

Users interested in the event.

/declined

Users who declined the event invitation.

/maybe

Users who replied that maybe will be attending the event.

/photos

Photos published to the event.

/picture

Event cover picture.

/feed

The feed of posts (including status updates) and links published to this event's wall.

Examples


Creating an event

POST /{group-id}/events?name=My%20Event&start_time=2019-08-06T23%3A00&end_time=2019-08-06T23%3A30 HTTP/1.1
Host: graph.facebook.com

You cannot create an event on the past.


Get the total number of people attending or declining an event

GET /{event-id}?fields=id,description,attending_count,declined_count HTTP/1.1
Host: graph.facebook.com


Deleting an event

DELETE /{event-id} HTTP/1.1
Host: graph.facebook.com