The Facebook Pages that a person owns or is able to perform tasks on.
Pages the User has a role on
GET /v21.0/{user-id}/accounts 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(
'/{user-id}/accounts',
'{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(
"/{user-id}/accounts",
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{user-id}/accounts",
null,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{user-id}/accounts"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
Reading from this edge will return a JSON formatted result:
{ "
data
": [], "paging
": {}, "summary
": {} }
data
The following fields will be added to each node that is returned:
Field | Description |
---|---|
tasks list<enum> | The User's tasks assigned to the Page. |
paging
summary
Aggregated information about the edge, such as counts. Specify the fields to fetch in the summary param (like summary=total_count
).
Field | Description |
---|---|
total_count int32 | Total number of objects on this edge |
Error | Description |
---|---|
459 | The session is invalid because the user has been checkpointed |
190 | Invalid OAuth 2.0 Access Token |
200 | Permissions error |
100 | Invalid parameter |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
80002 | There have been too many calls to this Instagram account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting. |
80001 | There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting. |
104 | Incorrect signature |
283 | That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata |
483 | The session is invalid because the user is in consent app blocking |
This API lets you create Facebook pages.
pages_manage_metadata
and pages_show_list
permissions.category_enum
parameter with a Page Category.name
, about
, picture
, and cover_photo
. Note: When setting the locale, at least one, city_id
, location
, or coordinates
, is required. Caveats:
city_id
and location
can not be used togethercity_id
and coordinates
can be used together however the coordinates must be within the city selectedlocation
and coordinates
can be used together however the coordinates must be within the location selectedaccounts
edge from the following paths: Parameter | Description |
---|---|
about UTF-8 encoded string | Short description |
address UTF-8 encoded string | Address |
category_enum string | Page category (enum). See Pages Categories API docs. |
category_list list<numeric string> | List of categories |
city_id city id | City ID |
coordinates JSON-encoded coordinate list | Coordinates |
cover_photo Object | Cover photo |
description UTF-8 encoded string | Description |
ignore_coordinate_warnings boolean | If ignore warnings generated in coordination validation (bool) |
location Object | This defines the location for this page. This is required if |
name UTF-8 encoded string | Page name Required |
phone UTF-8 encoded string | Phone |
picture URL | Profile picture |
website URL | Website |
zip string | Zipcode |
id
in the return type.id
: numeric string, Error | Description |
---|---|
200 | Permissions error |
100 | Invalid parameter |
152 | Invalid page type |
190 | Invalid OAuth 2.0 Access Token |