Facebook

Post to Facebook via API — Schedule, Publish, Analyze

Publish Reels, feed videos, images, and text to Facebook Pages. Route content to the right surface with a single parameter, plus 24/7 live streaming on Pro.

Get Started FreeNo credit card required

Facebook content types via API

Four post types, one endpoint.

Facebook Reelspost_type: video / facebook_media_type: REELS

Publish short-form vertical video as Facebook Reels. Set facebook_media_type to REELS to route to the Reels surface.

Facebook Video (feed)facebook_media_type: VIDEO

Post standard horizontal video to the Facebook page feed. Ideal for long-form content and reposts from YouTube.

Image postspost_type: image

Post single images or photo albums to a Facebook Page. Attach descriptions and links in the same request.

Text-only postspost_type: text

Publish text-only status updates to Facebook Pages. Useful for announcements, quotes, and engagement posts.

24/7 Facebook LiveLive streaming (Pro+)

Run always-on RTMP streams to your Facebook Page. Loop playlists or run live shows 24/7 — no separate streaming software needed.

API Example

Facebook Reel from one API call

Set facebook_media_type to REELS and CodivUpload routes your video directly to the Facebook Reels surface — no separate upload flow required.

facebook-reel.sh
# Post a Facebook Reel
curl -X POST \
  https://api.codivupload.com/v1/posts \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "profile_name": "my-page",
    "platforms": ["facebook"],
    "post_type": "video",
    "description": "Product launch highlight reel",
    "media_urls": ["https://cdn.example.com/launch.mp4"],
    "facebook_media_type": "REELS",
    "scheduled_date": "2026-04-02T18:00:00Z"  }'
Setup

Getting started with Facebook

Connecting a Facebook Page takes under two minutes. CodivUpload uses OAuth to request only the permissions it needs — no passwords are stored, and you can revoke access at any time from your Facebook settings.

1

Connect via OAuth

Go to the Integrations tab in your CodivUpload dashboard and click Connect Facebook. Sign in with the Facebook account that manages the Page you want to publish to. Grant the requested permissions (pages_manage_posts, pages_read_engagement).

2

Select your Page

After authorization, CodivUpload lists all Pages your Facebook account manages. Select the Page you want to publish to. You can connect additional Pages at any time — each one appears as a separate profile in the dashboard.

3

Choose post type

From the compose screen, select your Facebook profile and pick a post type: Reel, Video, Image, or Text. Add your description, attach media, set a schedule, and publish. The API works identically — set post_type and facebook_media_type in the request body.

Facebook content types in detail

Facebook supports a wider range of content formats than most platforms. Here is what you can publish through CodivUpload and the specifications for each format.

Video (up to 240 minutes)

Standard feed video supports files up to 10 GB and 240 minutes in duration. Accepted formats are MP4 and MOV with H.264 encoding. Facebook processes the video server-side after upload, so there is no additional transcoding needed on your end. Set facebook_media_type: VIDEO for feed placement.

Reels (short-form vertical)

Reels are vertical videos (9:16 aspect ratio) up to 90 seconds. They appear in the dedicated Reels tab, Explore feed, and can surface on the main News Feed. Reels consistently get higher organic reach than standard feed posts. Set facebook_media_type: REELS and CodivUpload routes the upload to the Reels surface automatically.

Image posts

Single images or photo albums. Supported formats include JPEG, PNG, and WebP. Maximum resolution is 2048x2048 pixels for optimal quality. You can attach multiple image URLs in the media_urls array to create an album. Each image can have its own description when using platform overrides.

Link posts

Include any URL in the description and Facebook generates a rich link preview using the target page's Open Graph tags. The preview includes the page title, description, and image. Link posts are great for driving traffic to blog articles, product pages, or landing pages.

Text posts (up to 63,206 characters)

Facebook allows up to 63,206 characters per text post — far more than any other major platform. Text-only posts work well for announcements, polls, questions, and engagement-driven content. The algorithm tends to favor text posts that generate comments, so pair them with a call to action.

Facebook via API

Schedule a Facebook image post

The example on the right schedules an image post to a Facebook Page for a specific date and time. The facebook_media_type parameter is optional for image posts — it defaults to the standard feed placement.

All Facebook-specific parameters use the facebook_ prefix. See the full API reference for every supported parameter.

facebook-image.sh
# Schedule a Facebook image post
curl -X POST \
  https://api.codivupload.com/v1/posts \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "profile_name": "my-page",
    "platforms": ["facebook"],
    "post_type": "image",
    "description": "Behind the scenes at our studio",
    "media_urls": [
      "https://cdn.example.com/bts-1.jpg",
      "https://cdn.example.com/bts-2.jpg"
    ],
    "scheduled_date": "2026-04-10T15:30:00Z"  }'
Resources

Related guides

How to cross-post to 12 platforms at once

Learn how to compose a single post and distribute it across Facebook, Instagram, TikTok, YouTube, X, LinkedIn, Threads, Bluesky, and Pinterest with platform-specific overrides.

Full API reference

Complete documentation for every endpoint, parameter, and response code. Includes Facebook-specific fields like facebook_media_type, scheduled_date, and media_urls.

Start posting to Facebook for free

2 profiles, 10 uploads/mo on the free plan. Upgrade for unlimited.

Get Started Free

Facebook API questions