---
title: "List Facebook Pages"
method: GET
path: "/v2/credentials/{credential_id}/facebook-pages"
tags: ["Credentials v2"]
---

# List Facebook Pages

`GET /v2/credentials/{credential_id}/facebook-pages`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/v2/credentials/{credential_id}/facebook-pages`
- Auth: HTTP bearer

List Facebook Pages the user manages for a given credential.

Returns page_id, name, and category for each Page.
The page_id is needed when creating a PlatformConfig for Facebook.

Supports shared credentials: if the caller is not the owner, they can
pass ?team_id=xxx to check access via SharedCredential.

## Path parameters

- `credential_id` string, required

## Query parameters

- `team_id` string, nullable: Team ID to check shared credential access

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Response `200`

Successful Response

- FacebookPagesListResponse: Response listing Facebook Pages for a credential.
  - `credential_id` string, required
  - `pages` FacebookPageResponse[], required
    - `page_id` string, required: Facebook Page ID
    - `name` string, required: Page name
    - `category` string, nullable: Page category (e.g., 'Media/News Company')
  - `total` integer, required
  - `selected_page_id` string, nullable: The Page this connection currently publishes to, or null when none is chosen. Change it with PATCH /{credential_id}/facebook-page.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jubjubapp/apis/jubjub-api.md) - [All operations](https://skmtc.dev/jubjubapp/apis/jubjub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jubjubapp/apis/jubjub-api/revisions/353157b296f2?raw)