# Facebook API: Posting Reference

Facebook is supported via the Facebook Graph API. OmniSocials posts to Facebook Pages (not personal profiles). The Facebook Page must be administered by the user who connects the account.

**Channel ID:** `facebook`

## Supported content types

| Type | Supported | Notes |
|------|-----------|-------|
| Feed post | ✅ | Text, image, video, carousel, or link preview |
| Story | ✅ | Image or video |
| Reel | ✅ | Vertical video |

## Minimal example

```bash
curl -X POST https://api.omnisocials.com/v1/posts/create \
  -H "Authorization: Bearer $OMNISOCIALS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": { "default": "Weekly update from the team" },
    "accounts": ["your-facebook-page-id"]
  }'
```

Unlike Instagram, Facebook accepts text-only posts with no media.

## Platform-specific options

Set these under the `facebook` key on the post body:

| Field | Type | Description |
|-------|------|-------------|
| `facebook.first_comment` | string | Text auto-posted as the first comment right after the post publishes (max 8000 characters). Page posts only — the API cannot comment on personal profiles. Not posted for stories. |

Facebook has no *required* option fields. Aside from the optional first comment, the default create-post body is sufficient for most use cases.

## Media requirements

| Media | Requirement |
|-------|-------------|
| Image | JPEG, PNG, GIF, or WebP. Max 30 MB. |
| Video | MP4 or MOV, up to 240 minutes, max 1 GB |
| Story image | JPEG or PNG, 9:16 recommended |
| Story video | MP4, up to 60 seconds |
| Reel video | MP4, vertical 9:16, 3 to 90 seconds |
| Carousel | 2 to 10 media items |

## Limitations

- Personal Facebook profiles (not Pages) are not supported
- Posts to Groups are not currently supported
- Link previews are generated automatically from the first URL in the post content when no media is attached
- Facebook's API does not guarantee delivery timing for scheduled posts. Expect publish times within a few minutes of the scheduled time.