---
title: "List Facebook text-post background presets"
method: GET
path: "/api/v1/facebook/text-backgrounds"
tags: ["📝 Posts"]
---

# List Facebook text-post background presets

`GET /api/v1/facebook/text-backgrounds`

Returns the full list of Facebook colored-background preset IDs accepted by `facebook_options.facebook_background_id` on POST /api/v1/workspaces/{workspace_id}/posts. Backgrounds only apply to plain text posts (no media, no link).

## Response `200`

Text backgrounds retrieved successfully

- object
  - `status` boolean
  - `message` string
  - `data` object[]
    - `id` string — Preset ID to pass as facebook_options.facebook_background_id
    - `type` 'solid' | 'gradient' | 'image'
    - `background_color` string — CSS background value. Empty string for image-type presets.
    - `color` string — Text color that pairs with the background.
    - `description` string
    - `category` 'ranked' | 'popular' | 'new' | 'more'

## Other responses

- `401` — Unauthorized - Invalid API key
- `429` — Too many requests

---

[API](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1.md) · [All operations](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contentstudio/contentstudio-api-v1/revisions/ec0c85521883/schema)