Accounts
Update Facebook page details
Edit the page’s public details. Send only the fields you want to change.
Each field is saved on Facebook separately, in the order about, description, phone, website, emails, hours. If Facebook refuses one, the request stops there and returns 422 PLATFORM_ERROR: details.field names the refused field and details.saved_fields lists the fields already saved. Fields after the refused one are not sent.
Needs the page-metadata permission on the connection. Pages connected through an older flow that never requested it get reconnect_required rather than a silent no-op.
Requires scope social:write.
PATCH
/
social
/
accounts
/
{account_id}
/
facebook
/
page
Update Facebook page details
curl --request PATCH \
--url https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"about": "<string>",
"description": "<string>",
"phone": "<string>",
"website": "<string>",
"emails": [
"<string>"
],
"hours": {}
}
'import requests
url = "https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page"
payload = {
"about": "<string>",
"description": "<string>",
"phone": "<string>",
"website": "<string>",
"emails": ["<string>"],
"hours": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
about: '<string>',
description: '<string>',
phone: '<string>',
website: '<string>',
emails: ['<string>'],
hours: {}
})
};
fetch('https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'about' => '<string>',
'description' => '<string>',
'phone' => '<string>',
'website' => '<string>',
'emails' => [
'<string>'
],
'hours' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page"
payload := strings.NewReader("{\n \"about\": \"<string>\",\n \"description\": \"<string>\",\n \"phone\": \"<string>\",\n \"website\": \"<string>\",\n \"emails\": [\n \"<string>\"\n ],\n \"hours\": {}\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"about\": \"<string>\",\n \"description\": \"<string>\",\n \"phone\": \"<string>\",\n \"website\": \"<string>\",\n \"emails\": [\n \"<string>\"\n ],\n \"hours\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"about\": \"<string>\",\n \"description\": \"<string>\",\n \"phone\": \"<string>\",\n \"website\": \"<string>\",\n \"emails\": [\n \"<string>\"\n ],\n \"hours\": {}\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"updated": true,
"fields": [
"<string>"
]
}
}Authorizations
API key from Developer dashboard (Bearer token).
Path Parameters
Connected social account id.
Body
application/json
⌘I
Update Facebook page details
curl --request PATCH \
--url https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"about": "<string>",
"description": "<string>",
"phone": "<string>",
"website": "<string>",
"emails": [
"<string>"
],
"hours": {}
}
'import requests
url = "https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page"
payload = {
"about": "<string>",
"description": "<string>",
"phone": "<string>",
"website": "<string>",
"emails": ["<string>"],
"hours": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
about: '<string>',
description: '<string>',
phone: '<string>',
website: '<string>',
emails: ['<string>'],
hours: {}
})
};
fetch('https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'about' => '<string>',
'description' => '<string>',
'phone' => '<string>',
'website' => '<string>',
'emails' => [
'<string>'
],
'hours' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page"
payload := strings.NewReader("{\n \"about\": \"<string>\",\n \"description\": \"<string>\",\n \"phone\": \"<string>\",\n \"website\": \"<string>\",\n \"emails\": [\n \"<string>\"\n ],\n \"hours\": {}\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"about\": \"<string>\",\n \"description\": \"<string>\",\n \"phone\": \"<string>\",\n \"website\": \"<string>\",\n \"emails\": [\n \"<string>\"\n ],\n \"hours\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"about\": \"<string>\",\n \"description\": \"<string>\",\n \"phone\": \"<string>\",\n \"website\": \"<string>\",\n \"emails\": [\n \"<string>\"\n ],\n \"hours\": {}\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"updated": true,
"fields": [
"<string>"
]
}
}
