---
title: "List Facebook text background presets"
method: GET
path: "/api/v1/misc/facebook/text-format-presets"
tags: ["misc"]
---

# List Facebook text background presets

`GET /api/v1/misc/facebook/text-format-presets`

## Request

- Base URL: `https://api.bundle.social`
- URL: `https://api.bundle.social/api/v1/misc/facebook/text-format-presets`
- Auth: API key in header `x-api-key`

Return the text background presets (colored statuses) that can be passed as data.FACEBOOK.textFormatPresetId, grouped by whether each one renders as a flat color, a gradient, or an illustration. Facebook exposes no endpoint of its own for this, so read the list from here instead of hardcoding IDs. Any other numeric ID is also accepted and passed straight through to Facebook.

## Response `200`

200

- object
  - `presets` object[], required
    - `id` string, required: Value to pass as data.FACEBOOK.textFormatPresetId when creating a post.
    - `label` string, required: Name of the background, for showing in a picker.
    - `kind` 'color' | 'gradient' | 'illustration', required: Whether the background is a flat color, a gradient, or an illustration.
    - `color` string, nullable: CSS color or gradient the background renders. Absent for illustrations.

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `429`: 429
- `500`: 500
- `502`: 502
- `503`: 503
- `504`: 504

## Changes

- **2026-11-03** `fb6e4fbd8d2f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bundle/apis/bundle-social-api/changes/api/v1/misc/facebook/text-format-presets/get.md)

---

[API](https://skmtc.dev/bundle/apis/bundle-social-api.md) - [All operations](https://skmtc.dev/bundle/apis/bundle-social-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bundle/apis/bundle-social-api/revisions/18efa1cb93a4?raw)