Posts

Publish reels to a Facebook Page via API

With format reels and integration_slug facebook, Connect publishes a reel to the Page your customer connected. Video on a Facebook Page goes through this format.

The request

POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "external_reference": "fb-reel-55",
  "format": "reels",
  "caption": "Bastidores da loja",
  "media": [
    {
      "type": "video",
      "url": "https://cdn.example.com/reel.mp4"
    }
  ],
  "facebook": {
    "title": "Bastidores",
    "cover_url": "https://cdn.example.com/capa.jpg"
  }
}

What you can do

  • Publish a reel from a public https:// video URL.
  • Set the title with facebook.title.
  • Pick the cover with facebook.cover_url.
  • Target the Page by connection or by integration_slug and source_name.

Rules and limits

  • Reels takes exactly 1 video.
  • The title goes up to 255 characters.
  • If the network refuses the cover_url image, the reel goes out with the cover it picks.
  • The answer is 202: publishing runs in the background. Follow it with GET /posts/{uuid}.
  • external_reference is required and Idempotency-Key avoids duplicating the publication.

Main fields

FieldTypeRequiredDescription
external_referencestringYesThe post's id in your system (up to 100 characters). Prevents publishing the same post twice on the same account.
formatstringYesPost format. On Instagram: feed, reels or story. On Facebook: feed, reels or story.
captionstringNoPost text. Up to 2200 characters. Stories carry no caption.
mediaarrayYesList of media, in order. Each item has type and url.
media.urlstringYesPublic https:// URL the network can download (up to 2048 characters).
facebook.titlestringNoReel title, up to 255 characters. Reels only.
facebook.cover_urlstringNohttps:// URL of the reel's cover. If the network refuses the image, the reel goes out with the cover it picks. Reels only.

Who it is for

  • Video tool

    Your SaaS publishes the exported short video straight to the customer's Page, with title and cover.

  • Agency

    Publish the same reel to several clients' Pages with one call per connection.

  • AI agent

    An agent generates the video, sets the title and publishes the reel with no intervention.

Works with

  • Facebook

Frequently asked questions

Why can't I send video on the feed?

The Page feed refuses video: Page video goes as reels.

Can I choose the cover?

Yes, with facebook.cover_url. If the network refuses the image, the reel goes out with the cover it picks.

How many videos per reel?

Exactly 1.

Related

See everything you can do with Posts

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.