POST api/v4/workspaces/facebook_pages
Create Workspace Facebook Pages. Last update: 08/08/23

Request headers ↑

Only registered user can perform this action
  Authentication - string - required
    Example of Authentication header : "Bearer TOKEN_FETCHED_FROM_SERVER_DURING_REGISTRATION"

Request body example ↑

{
  "facebook_account": {
    "fb_token": "FB_TOKEN",
    "rb_uid": "FB_UID",
    "location": personalSettingsPage
  },
  "fb_pages": [
    {
      "id": "FB_PAGE_UID",
      "name": "Ov_dev_sl_2",
      "access_token": "ACCESS_TOKEN",
      "picture": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/344871424_1571948339950824_3238105955092709413_n.png?stp=cp0_dst-png_p50x50&_nc_cat=111&ccb=1-7&_nc_sid=dbb9e7&_nc_ohc=nbK0WSHJcMkAX8hTPGc&_nc_ht=scontent-iad3-1.xx&edm=AGaHXAAEAAAA&oh=00_AfAYv8ssm2oogVS5zx2wxwFEwMQcYfDotdUQNct5apnzpg&oe=6457D34B"
    },
    ...
  ]
}

Success response body ↑

{
  "success": true,
  "fb_pages": [
    {
      "id": 6,
      "fb_token": "ACCESS_TOKEN",
      "fb_uid": "FB_PAGE_UID_3",
      "fb_name": "Ov_dev_sl_3",
      "facebook_account_id": 2,
      "created_at": "2023-06-14T17:06:02.456Z",
      "updated_at": "2023-06-14T17:06:02.456Z",
      "logo_url": "url",
      "nickname": "",
      "connected_teams": null,
      "is_silhouette": true
    }
  ],
  "message": [
    "Facebook page Ov_dev_sl_2 not conncted. To connect this social media account to your Workspace, you must first remove it from your Personal accounts"
  ]
}

Errors

Code Description
422 Could not save the entity.

Params

Param name Description
facebook_account
required

Validations:

  • Must be a Hash
facebook_account[fb_token]
required

Validations:

  • Must be a String
facebook_account[fb_uid]
required

Validations:

  • Must be a String
facebook_account[location]
optional

Validations:

  • Must be one of: workspaceSettingsPage, signUpForm, guidedWalkthrough, progressMeter, personalSettingsPage, templateBranding.
fb_pages
optional

Validations:

  • Must be an Array of nested elements
fb_pages[access_token]
required

Validations:

  • Must be a String
fb_pages[id]
required

Validations:

  • Must be a String
fb_pages[name]
required

Validations:

  • Must be a String
fb_pages[picture]
required

Validations:

  • Must be a String
fb_pages[is_silhouette]
required

Validations:

  • Must be one of: true, false, 1, 0.