Graph API Version

Life Event

The Life Event node part of the data returned for a Page's milestone edge.

Access to a person's 'Born' life event requires the user_birthday permission.

Reading

Page milestone information

Example

Graph API Explorer
GET /v2.11/{life-event-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{life-event-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{life-event-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{life-event-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{life-event-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

FieldDescription

created_time

datetime

The time when this milestone was published

description

string

Description of the milestone

end_time

datetime

The time when this milestone came to an end

from

The information of the Page that ownes the milestone

id

numeric string

The milestone ID

is_hidden

bool

Whether the milestone is hidden or not

start_time

datetime

The time when this milestone was started

title

string

The title of the milestone

updated_time

datetime

The time when this milestone was updated

Edges

EdgeDescription

comments

Comments on this milestone

likes

Likes on this milestone

photos

Photos attached with this milestone

sharedposts

Shared posts

Validation Rules

ErrorDescription
100Invalid parameter

Creating

Example

You can make a POST request to milestones edge from the following paths:
When posting to this edge, a LifeEvent will be created.

Parameters

NameDescription
description
string

Description

Required
start_time
datetime

Time of the Milestone

Required
title
string

Title

Required

Return Type

This endpoint supports read-after-write and will read the node represented by id in the return type.
Struct {
id: numeric string,
}
You may perform a POST request to the following edge from this node:

Validation Rules

ErrorDescription
210User not visible

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.