Facebook Publishing Docs

Publish Facebook Page feed posts, images, and Reels with the Postifys API: fields, cURL examples, permissions, and limits.

Last updated: 2026-07-24 · Technical source: live Postifys API behavior and API reference

What Postifys supports

Native photo, Reel, or text/link feed posts on a connected Facebook Page.

Product overview: Facebook integration. Full field reference also lives on API docs.

Endpoint

POST /api/facebook/post · Auth: API key or session · Target field: pageId when needed

Permissions / scopes (as granted): pages_manage_posts, pages_read_engagement (as granted via Meta connection)

Common fields

• text / message - Optional if media or link is present.
• mediaUrls - Array or URL; required for images and Reels.
• link - Optional fallback URL for feed posts.
• type - IMAGE, REEL, or FEED. Defaults based on payload.
• pageId - Optional connected Facebook Page ID.
• proxyDownload - Download media first; auto for Drive/Dropbox.

cURL example

curl -X POST https://postifys.com/api/facebook/post \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "text": "New image from Postifys API",
    "type": "IMAGE",
    "mediaUrls": ["https://example.com/image.jpg"],
    "pageId": "FACEBOOK_PAGE_ID"
  }'

Limitations

• Targets Facebook Pages, not personal profile walls.
• Requires Meta Page publishing permissions on the connected account.
• Media rules follow Meta Page/Reel requirements.

See also Media requirements, Errors, and Rate limits.