> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook Settings

> Provider settings for Facebook posts

## Overview

Facebook integration allows you to post to Facebook pages. You can optionally include a link URL in your posts.

## Settings Schema

```json theme={null}
{
  "__type": "facebook",
  "url": "https://example.com/my-article",
  "post_type": "post"
}
```

## Properties

| Property                | Type   | Required | Description                              |
| ----------------------- | ------ | -------- | ---------------------------------------- |
| `__type`                | string | ✅        | Must be `"facebook"`                     |
| `url`                   | string | ❌        | Optional link URL to include in the post |
| `post_type`             | string | ❌        | `post` (default) or `story`              |
| `text_format_preset_id` | string | ❌        | Background preset for a text-only post   |

### `post_type`

| Value   | Description                                                                                            |
| ------- | ------------------------------------------------------------------------------------------------------ |
| `post`  | A normal Page post. This is the default                                                                |
| `story` | A Facebook story. Requires at least one attachment, and **each attachment publishes as its own story** |

### `text_format_preset_id`

Facebook lets a short text-only post render on a coloured or illustrated
background. Pass the preset ID to use one.

Constraints, all enforced by Facebook rather than Postiz:

* **Text only.** A post with media ignores the preset.
* **Pages only.**
* **130 characters maximum.** Longer text drops the background.

Facebook publishes no API to enumerate the presets, so Postiz ships a fixed
catalogue of them. Pick one in the app to find the ID you want, then reuse that
ID over the API.

## Examples

### Simple text post

```json theme={null}
{
  "type": "now",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-facebook-integration-id"
      },
      "value": [
        {
          "content": "Check out our latest updates! 🎉",
          "image": []
        }
      ],
      "settings": {
        "__type": "facebook"
      }
    }
  ]
}
```

### Post with link

```json theme={null}
{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-facebook-integration-id"
      },
      "value": [
        {
          "content": "We just published a new blog post about social media automation!",
          "image": []
        }
      ],
      "settings": {
        "__type": "facebook",
        "url": "https://example.com/blog/social-media-automation"
      }
    }
  ]
}
```

### Post with image

```json theme={null}
{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-facebook-integration-id"
      },
      "value": [
        {
          "content": "Beautiful sunset from our office! 🌅",
          "image": [
            {
              "id": "img-123",
              "path": "https://uploads.postiz.com/sunset.jpg"
            }
          ]
        }
      ],
      "settings": {
        "__type": "facebook"
      }
    }
  ]
}
```

## Notes

* The `url` field is optional and creates a link preview in the post
* If posting with images, Facebook will display them as attachments
* Video uploads are also supported