Back to top

Facebook

Overview

Resource Group

get facebook pages that user has access

get facebook pages that user has access
GET/brands/:brand/users/self/facebook

if you provide allAvailablePages = true in query string, you get all the facebook pages this user has access, but if you don’t provide this, it means it returns all the facbook pages this user connected

Example URI

GET /brands/:brand/users/self/facebook
URI Parameters
HideShow
brand
string (required) Example: 189cbdd0-ad70-4378-b31d-09ad74f9e8ed
allAvailablePages
string (required) Example: true
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "844a178a-4029-4a61-aec3-2cbf2bb95179",
      "name": "page1",
      "facebook_page_id": "page1Id",
      "instagram_business_account_id": "insta1",
      "instagram_username": "instagram1",
      "instagram_profile_picture_url": "https://test.cloudfront.net/80a227b2-29a0-11e7-b636-e4a7a08e15d4/instagramAvatars/c9050120-a933-11f0-bdea-d5cf17ea076e.jpg",
      "instagram_profile_picture_file": "35092aa7-efd8-4311-a0bb-a757b564baf8",
      "instagram_id": null,
      "revoked": false,
      "sub_team_usage_enabled_at": null,
      "created_at": 1760470033.134281,
      "updated_at": 1760470033.134283,
      "deleted_at": null,
      "brand": "189cbdd0-ad70-4378-b31d-09ad74f9e8ed",
      "user": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "type": "facebook_page"
    },
    {
      "id": "b88452f6-dd3f-4900-8b42-fac9fbe297d7",
      "name": "page2",
      "facebook_page_id": "page2Id",
      "instagram_business_account_id": "insta2",
      "instagram_username": "instagram2",
      "instagram_profile_picture_url": "https://test.cloudfront.net/80a227b2-29a0-11e7-b636-e4a7a08e15d4/instagramAvatars/c91331f0-a933-11f0-bdea-d5cf17ea076e.jpg",
      "instagram_profile_picture_file": "0cb048a5-06c7-4c93-bea0-b81db594c88a",
      "instagram_id": null,
      "revoked": false,
      "sub_team_usage_enabled_at": null,
      "created_at": 1760470033.134356,
      "updated_at": 1760470033.134357,
      "deleted_at": null,
      "brand": "189cbdd0-ad70-4378-b31d-09ad74f9e8ed",
      "user": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "type": "facebook_page"
    },
    {
      "id": "61592662-7e28-48e3-93dc-7ef9436f7036",
      "name": "page2",
      "facebook_page_id": "asdsfsdfasd",
      "instagram_business_account_id": "insta3",
      "instagram_username": "instagram3",
      "instagram_profile_picture_url": "https://test.cloudfront.net/80a227b2-29a0-11e7-b636-e4a7a08e15d4/instagramAvatars/c935d520-a933-11f0-bdea-d5cf17ea076e.jpg",
      "instagram_profile_picture_file": "533caa05-8b81-4815-ae2a-4ba8c5e766a1",
      "instagram_id": null,
      "revoked": false,
      "sub_team_usage_enabled_at": null,
      "created_at": 1760470033.288111,
      "updated_at": 1760470033.288112,
      "deleted_at": null,
      "brand": "189cbdd0-ad70-4378-b31d-09ad74f9e8ed",
      "user": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "type": "facebook_page"
    }
  ],
  "info": {
    "count": 3,
    "total": 0
  }
}

Disconnect a facebook page that can be done as owner of the page

Disconnect a facebook page that can be done as owner of the page
DELETE/brands/:brand/users/self/facebook/:facebookPageId

Example URI

DELETE /brands/:brand/users/self/facebook/:facebookPageId
URI Parameters
HideShow
brand
string (required) Example: 189cbdd0-ad70-4378-b31d-09ad74f9e8ed
facebookPageId
string (required) Example: 61592662-7e28-48e3-93dc-7ef9436f7036
Response  204

toggle sub team usage of a facebook page that can be done as owner of the page

toggle sub team usage of a facebook page that can be done as owner of the page
PUT/brands/:brand/users/self/facebook/:facebookPageId/access

Example URI

PUT /brands/:brand/users/self/facebook/:facebookPageId/access
URI Parameters
HideShow
brand
string (required) Example: 189cbdd0-ad70-4378-b31d-09ad74f9e8ed
facebookPageId
string (required) Example: 61592662-7e28-48e3-93dc-7ef9436f7036
Request
HideShow
Body
{
  "subTeamUsageEnabled": true
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "61592662-7e28-48e3-93dc-7ef9436f7036",
    "name": "page2",
    "facebook_page_id": "asdsfsdfasd",
    "instagram_business_account_id": "insta3",
    "instagram_username": "instagram3",
    "instagram_profile_picture_url": "https://test.cloudfront.net/80a227b2-29a0-11e7-b636-e4a7a08e15d4/instagramAvatars/c935d520-a933-11f0-bdea-d5cf17ea076e.jpg",
    "instagram_profile_picture_file": "533caa05-8b81-4815-ae2a-4ba8c5e766a1",
    "instagram_id": null,
    "revoked": false,
    "sub_team_usage_enabled_at": 1760470032.407036,
    "created_at": 1760470033.288111,
    "updated_at": 1760470033.288112,
    "deleted_at": null,
    "brand": "189cbdd0-ad70-4378-b31d-09ad74f9e8ed",
    "user": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "type": "facebook_page"
  }
}

Generated by aglio on 14 Oct 2025