Accounts

Set Facebook page cover photo

Replace the Page’s cover photo with the image at url. Facebook downloads the image from that URL itself. No feed story is created and followers are not notified. A cover photo can be replaced through the API but not removed - removing it has to be done on Facebook.

The image must be JPG, PNG, GIF, BMP or TIFF, 10 MB or smaller, and at least 400 x 150 px. 851 x 315 px is recommended (not enforced). An image that fails a check is refused with 422 VALIDATION_ERROR, with details.field set to url and details.reason one of invalid_url, unreachable, too_large, unsupported_type or too_small.

Needs the business permission on the connection. Connections without it get 403 CONNECTION_SCOPE_MISSING with reconnect_required: true - reconnect the account to fix it.

With a test key (sqk_test_...) the request is validated, including the image URL, and a success response is returned without contacting Facebook.

Requires scope social:write.

POST

social

accounts

{account_id}

facebook

page

cover

Set Facebook page cover photo

curl --request POST \
  --url https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page/cover \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://example.com/images/cover-851x315.jpg",
  "offset_y": 50
}
'

import requests

url = "https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page/cover"

payload = {
    "url": "https://example.com/images/cover-851x315.jpg",
    "offset_y": 50
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({url: 'https://example.com/images/cover-851x315.jpg', offset_y: 50})
};

fetch('https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page/cover', 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/cover",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => 'https://example.com/images/cover-851x315.jpg',
    'offset_y' => 50
  ]),
  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/cover"

	payload := strings.NewReader("{\n  \"url\": \"https://example.com/images/cover-851x315.jpg\",\n  \"offset_y\": 50\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page/cover")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"https://example.com/images/cover-851x315.jpg\",\n  \"offset_y\": 50\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page/cover")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"https://example.com/images/cover-851x315.jpg\",\n  \"offset_y\": 50\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "updated": true
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing or malformed Authorization header",
    "details": {}
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "API key lacks required scope: social:write",
    "details": {
      "required_scope": "social:write"
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Post not found.",
    "details": {}
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required fields: content, platforms.",
    "details": {
      "fields": [
        "content",
        "platforms"
      ]
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

Authorizations

Authorization

string

header

required

API key from Developer dashboard (Bearer token).

Path Parameters

account_id

integer

required

Connected social account id.

Body

application/json

url

string<uri>

required

URL of the image. JPG, PNG, GIF, BMP or TIFF, 10 MB max, at least 400 x 150 px.

offset_y

integer

default:50

Vertical offset of the image within the cover frame, 0-100.

Required range: 0 <= x <= 100

Response

Cover photo updated

success

enum<boolean>

Available options:

true

data

object

Show child attributes

Set Facebook page cover photo

curl --request POST \
  --url https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page/cover \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://example.com/images/cover-851x315.jpg",
  "offset_y": 50
}
'

import requests

url = "https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page/cover"

payload = {
    "url": "https://example.com/images/cover-851x315.jpg",
    "offset_y": 50
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({url: 'https://example.com/images/cover-851x315.jpg', offset_y: 50})
};

fetch('https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page/cover', 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/cover",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => 'https://example.com/images/cover-851x315.jpg',
    'offset_y' => 50
  ]),
  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/cover"

	payload := strings.NewReader("{\n  \"url\": \"https://example.com/images/cover-851x315.jpg\",\n  \"offset_y\": 50\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page/cover")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"https://example.com/images/cover-851x315.jpg\",\n  \"offset_y\": 50\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.smartlyq.com/v1/social/accounts/{account_id}/facebook/page/cover")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"https://example.com/images/cover-851x315.jpg\",\n  \"offset_y\": 50\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "updated": true
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing or malformed Authorization header",
    "details": {}
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "API key lacks required scope: social:write",
    "details": {
      "required_scope": "social:write"
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Post not found.",
    "details": {}
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required fields: content, platforms.",
    "details": {
      "fields": [
        "content",
        "platforms"
      ]
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

Core

CRM

Profiles

AI Generation

Social

Ads

WhatsApp

Inbox

AI Assistants

Set Facebook page cover photo

Authorizations

Path Parameters

Body

Response