Marketing API Version

Connection Objects

Connection Objects are the Facebook objects such as pages, apps and other assets which the user or business is an administrator. In the case of apps, the user or business may be the developer or advertiser. As an administrator of these objects you have the exclusive right to run ads on behalf of these objects as well as target users based on their connection to this object. For example, only a Page Administrator can target ads at the fans of their page.

The types of connection objects are:

Pages and Places

If someone is an admin of pages within a specific business manager account, you can get a list of these pages. Query the business's owned_page edge with an access token with pages_show_list permission:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

See Business Manager, Assets

You can also get a list of all pages a person is an admin for with their access token with pages_show_list permission:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<USER_ID>/accounts"

Optional filters for ..{USER_ID}/accounts queries:

Filter Description

business_id

int

Filter and return pages belonging to this business.

is_business

boolean

Filter and return pages for which you are admin, but are or are not associated with a business. If not specified, returns all pages you are an admin on.

is_promotable

boolean

If set to TRUE return all pages which can be promoted.. If not specified, returns all pages.

is_place

boolean

Filter all pages which are/are not place pages. If not specified, returns all pages.

See also Pages API

Events

The endpoint /{user-id}/promotable_events has been deprecated.

Apps

You can list all apps for a specific business manager that you can advertise for. Query the business's owned_apps edge with an access token with ads_management permissions:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_apps"

See also Business Manager, Apps

To list all apps that a person can promote, make the following query with an access token with ads_management or ads_read permissions:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/advertisable_applications"

Optional filters:

Filter Description

business_id

int

Filter and return all apps belonging to this business.

app_id

int

Filter to show only this app

See also Application API