Marketing API Version

Connection Objects

Connection Objects are the Facebook objects (e.g. pages, apps, etc) which the user or business is an administrator of (or developer/advertiser in the case of apps). By being an administrator of these objects they have the exclusive right to run ads on behalf of these objects as well as target users based on their connection to this object. E.g. 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 in within a specific business manager account, you can get a list of these pages. Query the business's page edge with an access token with manage_pages permission:

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

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

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

Optional filters:

FilterDescriptionType

business_id

Filter and return pages belonging to this business. This is equivalent to querying https://graph.facebook.com/<API_VERSION>/ <BUSINESS_ID>/pages

int

is_business

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.

boolean

is_promotable

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

boolean

is_place

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

boolean

Additional Reading: Pages API

Events

You can get the promotable events you created or get promotable page events that belong to pages you are an admin for. Make the following query with an access token with either ads_read or ads_management and manage_pages (if page event) and user_events permissions:

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

Optional filters:

FilterDescriptionType

is_page_event

Filter all events only owned by pages when set to true, or all events only owned by people when set to false

boolean

Additional Reading: Event API

Apps

You can list all apps for a specific business manager that you can advertise for. Query the business's 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>/apps"
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:

FilterDescriptionType

business_id

Filter and return all apps belonging to this business. This is equivalent to querying https://graph.facebook.com/<API_VERSION>/ <BUSINESS_ID>/apps

int

app_id

Filter to show only this app

int

Additional Reading: Application API

Domains

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

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<USER_ID>/promotable_domains"
Additional Reading: Domain API