JUjubjubapp
Credentials v2

Set Facebook Page

Choose the Page this Facebook connection publishes to.

The Graph API publishes to a Page, never to the account, and an account may manage several. Until this route existed the callback kept whichever Page Meta listed first and nothing could change it. The choice is checked against Meta live: page_id must be a Page the account manages NOW, not one the client remembered.

OWNER ONLY. A team member publishing through a shared credential can read the list (GET facebook-pages, with ?team_id) but not move the owner's connection to another Page.

Applies forward to every config created from now on (platform_config_routes._seed_connection_settings), and fills the Page into this credential's existing Facebook configs that carry none, which is what an INCOMPLETE Facebook destination needed to become READY. Configs that already name a Page are left alone: that was a choice.

patch/v2/credentials/{credential_id}/facebook-page

Request

  • Base URL
    https://api.jubjubapp.com (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

credential_idstring required

Headers

Authorizationstring
X-JubJub-Service-Keystring
X-JubJub-Agent-Keystring
X-JubJub-Platform-Keystring
Originstring
Refererstring
X-JubJub-Trial-Tokenstring

Request body

page_idstring required

A page_id from GET /{credential_id}/facebook-pages

Response

Successful Response

credential_idstring required
profile_idstring required
platformstring required
account_namestring required
account_usernamestring nullable required
account_idstring required
nicknamestring nullable required
account_labelstring nullable
display_namestring required

Best display name (nickname > account_name > account_username)

statusstring required
is_activeboolean required
needs_reauthboolean required
token_expires_atstring date-time nullable required
has_refresh_tokenboolean required
token_validboolean nullable

Result of live token validation against the platform API. None if not checked.

last_checked_atstring date-time nullable
last_check_sourcestring nullable
last_check_outcomestring nullable

alive | dead | undetermined

last_check_detailstring nullable
tokenise_destination_setboolean

True once a destination has been chosen for this channel.

tokenise_team_idstring nullable

Team the channel's imports tokenise to; null for solo.

tokenise_destination_modestring nullable

'team', 'solo', or null when no destination has been set.

facebook_page_idstring nullable
facebook_page_namestring nullable
granted_scopesstring[] nullable
reconnect_requiredobject nullable
created_atstring date-time required
updated_atstring date-time nullable required
last_used_atstring date-time nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.