Fresh 2026

Polls

You can use the API to create and manage polls on live video broadcasts that have a status of LIVE. Polls are represented by VideoPoll objects and are comprised of VideoPollOptions, which represent possible answers to the poll question.

Create a Poll

To create a poll on a live video broadcast, send a request to:

POST /{live-video-id}/polls?question={question}&options={options}

The targeted LiveVideo object must have a status of LIVE in order for the VideoPoll to be created. Upon success, the API will respond with the VideoPoll object's ID.

Query String Parameters

{question}, The poll question.
{options}, An array of possible answers.

Refer to the Live Video Polls edge reference for a complete list of query string parameters you can include when creating a poll.

Requirements

Type	Description
Access Tokens	An access token of a User or Page who created the LiveVideo.
Features	For a VideoPoll on a LiveVideo on a Group:<br>- Groups API
Permissions	For a VideoPoll on a LiveVideo on a User:<br>- `publish_video`<br>For a VideoPoll on a LiveVideo on a Page:<br>- `pages_read_engagement`<br>- `pages_manage_posts`<br>For a VideoPoll on a LiveVideo on a Group:<br>- `publish_to_groups`

Sample Request

cURLAndroid SDKObjective-CJava SDKPHP SDK

curl -i -X POST \
  "https://graph.facebook.com/v3.3/10214959467675612/polls
    ?question=What%20kind%20of%20bear%20is%20best%3F
    &options=%5B%22Black%20bear%22%2C%20%22Brown%20bear%22%2C%20%22That's%20a%20ridiculous%20question%22%5D
    &access_token={access-token}"

java

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/10214959467675612/polls",
  new JSONObject("{\"question\":\"What kind of bear is best?\",\"options\":\"[\"Brown bear\", \"Black bear\", \"That is a stupid question\", \"Basically, there are two schools of thought\"]\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]\
    initWithGraphPath:@"/10214959467675612/polls"\
           parameters:@{ @"question": @"What kind of bear is best?",@"options": @"['Brown bear', 'Black bear', 'That is a stupid question', 'Basically, there are two schools of thought']",}\
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {\
    // Insert your code here\
}];

java

FB.api(
  '/10214959467675612/polls',
  'POST',
  {"question":"What is the best bear?","options":"['Brown bear', 'Black bear', 'That is a stupid question', 'Basically, there are two schools of thought']"},
  function(response) {
      // Insert your code here
  }
);

cpp

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/10214959467675612/polls',
    array (
      'question' => 'What is the best bear?',
      'options' => '["Brown bear", "Black bear", "That is a stupid question", "Basically, there are two schools of thought"]'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Sample Response

json

{
  "id": "2318567914888258"  // VideoPoll ID
}

Close a Poll

To close a poll on a live video broadcast after a person has selected a poll option, send a request to:

POST /{video-poll-id}?action=CLOSE

Requirements

Type	Description
Access Tokens	An access token of a User who created the VideoPoll.
Features	For a VideoPoll on a LiveVideo on a Group:<br>- Groups API
Permissions	For a VideoPoll on a LiveVideo on a User:<br>- `publish_video`<br>For a VideoPoll on a LiveVideo on a Page:<br>- `pages_read_engagement`<br>- `page_manage_posts`<br>For a VideoPoll on a LiveVideo on a Group:<br>- `publish_to_groups`

Sample Request

cURLAndroid SDKObjective-CJava SDKPHP SDK

curl -i -X POST \
 "https://graph.facebook.com/{video-poll-id}?action=CLOSE&access_token={access-token}"

java

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{video-poll-id}",
  new JSONObject("{\"action\":\"CLOSE\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]\
    initWithGraphPath:@"/{video-poll-id}"\
           parameters:@{ @"action": @"CLOSE",}\
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {\
    // Insert your code here\
}];

java

FB.api(
  '/{video-poll-id}',
  'POST',
  {"action":"CLOSE"},
  function(response) {
      // Insert your code here
  }
);

cpp

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{video-poll-id}',
    array (
      'action' => 'CLOSE'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Sample Response

json

{
  "success": true
}

Reopen a Poll

To reopen a closed poll so a person can change their poll option, send a request to:

POST /{video-poll-id}?action=SHOW_VOTING

Requirements

Type	Description
Access Tokens	An access token of a User who created the VideoPoll.
Features	For a VideoPoll on a LiveVideo on a Group:<br>- Groups API
Permissions	For a VideoPoll on a LiveVideo on a User:<br>- `publish_video`<br>For a VideoPoll on a LiveVideo on a Page:<br>- `pages_read_engagement`<br>- `pages_manage_posts`<br>For a VideoPoll on a LiveVideo on a Group:<br>- `publish_to_groups`

Sample Request

cURLAndroid SDKObjective-CJava SDKPHP SDK

curl -i -X POST \
 "https://graph.facebook.com/{video-poll-id}
   ?action=SHOW_VOTING
   &access_token={access-token}"

java

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{video-poll-id}",
  new JSONObject("{\"action\":\"SHOW_VOTING\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]\
    initWithGraphPath:@"/{video-poll-id}"\
           parameters:@{ @"action": @"SHOW_VOTING",}\
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {\
    // Insert your code here\
}];

java

FB.api(
  '/{video-poll-id}',
  'POST',
  {"action":"SHOW_VOTING"},
  function(response) {
      // Insert your code here
  }
);

cpp

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{video-poll-id}',
    array (
      'action' => 'SHOW_VOTING'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Sample Response

json

{
  "success": true
}

Show Poll Results

To configure a poll to display results after a person has voted, send a request to:

POST /{video-poll-id}?action=SHOW_RESULTS

Requirements

Type	Description
Access Tokens	An access token of a User who created the VideoPoll.
Features	For a VideoPoll on a LiveVideo on a Group:<br>- Groups API
Permissions	For a VideoPoll on a LiveVideo on a User:<br>- `publish_video`<br>For a VideoPoll on a LiveVideo on a Page:<br>- `pages_read_engagement`<br>- `pages_manage_posts`<br>For a VideoPoll on a LiveVideo on a Group:<br>- `publish_to_groups`

Sample Request

cURLAndroid SDKObjective-CJava SDKPHP SDK

curl -i -X POST \
 "https://graph.facebook.com/{video-poll-id}
    ?action=SHOW_RESULTS
    &access_token={access-token}"

java

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{video-poll-id}",
  new JSONObject("{\"action\":\"SHOW_RESULTS\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]\
    initWithGraphPath:@"/{video-poll-id}"\
           parameters:@{ @"action": @"SHOW_RESULTS",}\
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {\
    // Insert your code here\
}];

java

FB.api(
  '/{video-poll-id}',
  'POST',
  {"action":"SHOW_RESULTS"},
  function(response) {
      // Insert your code here
  }
);

cpp

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{video-poll-id}',
    array (
      'action' => 'SHOW_RESULTS'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Sample Response

json

{
  "success": true
}

Get Poll Options

To get a poll's possible answers, send a request to:

GET /{video-poll-id}?fields=poll_options

GET /{video-poll-id}/poll_options

Refer to the VideoPoll reference for a list of available fields and edges.

Requirements

Type	Description
Access Tokens	An access token of a User who created the VideoPoll.
Features	For a VideoPoll on a LiveVideo on a Group:<br>- Groups API
Permissions	For a VideoPoll on a LiveVideo on a User:<br>- `publish_video`<br>For a VideoPoll on a LiveVideo on a Page:<br>- `pages_read_engagement`<br>- `pages_manage_posts`<br>For a VideoPoll on a LiveVideo on a Group:<br>- `publish_to_groups`

Sample Request

Gets a poll's possible answers:

cURLAndroid SDKObjective-CJava SDKPHP SDK

curl -i -X GET \
 "https://graph.intern.facebook.com/{video-poll-id}/poll_options
   ?fields=poll_options
   &access_token={access-token}"

java

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{video-poll-id}",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "poll_options");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]\
    initWithGraphPath:@"/{video-poll-id}"\
           parameters:@{ @"fields": @"poll_options",}\
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {\
    // Insert your code here\
}];

java

FB.api(
  '/{video-poll-id}',
  'GET',
  {"fields":"poll_options"},
  function(response) {
      // Insert your code here
  }
);

cpp

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{video-poll-id}',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Sample Response

An object containing a list of possible answers (a list of VideoPollOptions).

json

{
  "poll_options":
    {
      "data": [\
        {\
          "text": "Brown bear",\
          "id": 145049637\
        },\
        {\
          "text": "Black bear",\
          "id": 145049638\
        }\
        {\
          "text": "That is a stupid question",\
          "id": 145049639\
        }\
        {\
          "text": "Basically, there are two schools of thought",\
          "id": 145049640\
        }\
      ]
    },
  "id": 12345
}

Get Poll Option Votes

To get the number of votes on a poll option, send a request to:

GET /{video-poll-option-id}?fields=total_votes

Requirements

Type	Description
Access Tokens	An access token of a User who created the VideoPollOption.
Features	For a VideoPoll on a LiveVideo on a Group:<br>- Groups API
Permissions	For a VideoPoll on a LiveVideo on a User:<br>- `publish_video`<br>For a VideoPoll on a LiveVideo on a Page:<br>- `pages_read_engagement`<br>- `pages_manage_posts`<br>For a VideoPoll on a LiveVideo on a Group:<br>- `publish_to_groups`
Access Tokens	The same access token used to create the LiveVideo or Broadcast.

Sample Request

cURLAndroid SDKObjective-CJava SDKPHP SDK

curl -i -X GET \
 "https://graph.facebook.com/{video-poll-option-id}
   ?fields=total_votes
   &access_token={access-token}"

java

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{video-poll-option-id}",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "total_votes");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]\
    initWithGraphPath:@"/{video-poll-option-id}"\
           parameters:@{ @"fields": @"total_votes",}\
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {\
    // Insert your code here\
}];

java

FB.api(
  '/{video-poll-option-id}',
  'GET',
  {"fields":"total_votes"},
  function(response) {
      // Insert your code here
  }
);

cpp

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{video-poll-option-id}',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Sample Response

json

    {
  "total_votes": 129,
  "id": "{video-poll-option}"
}

Get All Poll Option Votes

To get the number of votes for each of the possible answers on a poll, use field expansion on the poll_options field to have the response include the total_votes field on any VideoPollOptions that are returned:

GET /{video-poll-id}?fields=poll_options{total_votes}

Requirements

Type	Description
Access Tokens	An access token of a User who created the LiveVideo.
Features	For a VideoPoll on a LiveVideo on a Group:<br>- Groups API
Permissions	For a VideoPoll on a LiveVideo on a User:<br>- `publish_video`<br>For a VideoPoll on a LiveVideo on a Page:<br>- `pages_read_engagement`<br>- `pages_manage_posts`<br>For a VideoPoll on a LiveVideo on a Group:<br>- `publish_to_groups`

Sample Request

Gets all of the VideoPollOptions and their text and total_votes fields on a VideoPoll.

cURLAndroid SDKObjective-CJava SDKPHP SDK

curl -i -X GET \
 "https://graph.intern.facebook.com/{video-poll-id}
   ?fields=poll_options{text,total_votes}
   &access_token={access-token}"

java

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{video-poll-id}",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "poll_options{text,total_votes}");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]\
    initWithGraphPath:@"/{video-poll-id}"\
           parameters:@{ @"fields": @"poll_options{text,total_votes}",}\
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {\
    // Insert your code here\
}];

java

FB.api(
  '/{video-poll-id}',
  'GET',
  {"fields":"poll_options{text,total_votes}"},
  function(response) {
      // Insert your code here
  }
);

cpp

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{video-poll-id}',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Sample Response

json

{
  "poll_options":
    {
      "data": [\
        {\
          "text": "Brown Bear",\
          "total_votes": 12,\
          "id": 145049637\
        },\
        {\
          "text": "Black Bear",\
          "total_votes": 87,\
          "id": 67890\
        }\
        {\
          "text": "That's a stupid question",\
          "total_votes": 45,\
          "id": 145049639\
        }\
        {\
          "text": "Basically, there are two schools of thought",\
          "total_votes": 12,\
          "id": 145049640\
        }\
      ]
    },
  "id": 12345
}

Application

Page

Post

User

Page

App

Object

User

Whats App Business Account

Getting Started

Timezone Ids

Custom Conversion

Extended Credit Invoice Group

Product Feed Upload

Product Item

Messaging Api

Ig Media

Ig User

Instagram Media

Guides

Guides

Guides

Guides

Getting Started

Rejection Guides

Class

App Review

Current

Polls ​

Create a Poll ​

Query String Parameters ​

Requirements ​

Sample Request ​

Sample Response ​

Close a Poll ​

Requirements ​

Sample Request ​

Sample Response ​

Reopen a Poll ​

Requirements ​

Polls

Create a Poll

Query String Parameters

Requirements

Sample Request

Sample Response

Close a Poll

Requirements

Sample Request

Sample Response

Reopen a Poll

Requirements