Posts
Publish to your customers' social accounts through one API
Your customer connects the accounts once. Your product publishes to Instagram, Facebook, Threads, LinkedIn, Pinterest and YouTube Shorts through the same endpoint, and follows each post to the end.
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "reel-310",
"format": "reels",
"caption": "Bastidores da campanha #reels",
"media": [
{
"type": "video",
"url": "https://cdn.example.com/reel.mp4"
}
],
"instagram": {
"share_to_feed": true,
"cover_url": "https://cdn.example.com/capa.jpg",
"first_comment": "Qual parte você mais gostou?"
}
}What you can do
Publish a carousel on InstagramPublish carousels of 2 to 10 images and videos on your customers' Instagram with one POST /posts call, no app review needed.
Publish reels on InstagramPublish reels on your customers' Instagram with POST /posts: cover, audio, profile grid and first comment, without handling Meta tokens.
Publish stories on InstagramPublish image or video stories on your customers' Instagram with POST /posts, with no app review and no token handling.
Publish trial reels on InstagramPublish trial reels on Instagram with POST /posts: the reel goes to non-followers first and is promoted by you or by performance.
Add collaborators to Instagram postsInvite up to 5 collaborators on Instagram posts, reels and stories with instagram.collaborators in POST /posts.
Post a first comment on InstagramPost a first comment together with an Instagram post using instagram.first_comment in POST /posts, on feed and reels.
Publish to a Facebook PagePublish text, a link or up to 10 photos to your customers' Facebook Page with POST /posts, with no app review and no token handling.
Publish reels to a Facebook PagePublish reels to your customers' Facebook Page with POST /posts, with title and cover, no app review and no token handling.
Publish stories to a Facebook PagePublish image or video stories to your customers' Facebook Page with POST /posts, with no app review and no token handling.
Publish to ThreadsPublish text, images and videos to your customers' Threads accounts through the API, with reply control, a topic tag and a first comment.
Publish to LinkedIn pagesPublish text, images, video or a PDF to your customer's LinkedIn company page through the API, in one call and with no OAuth of your own.
Publish to a LinkedIn personal profilePublish text, images, video or a document to a LinkedIn personal profile your customer's user connected, through the API, with no LinkedIn OAuth to build.
Publish pins to PinterestPublish image or video pins to the right board on your customer's Pinterest through the API, with title, destination link and board section.
Create and list Pinterest boardsCreate and list boards on your customer's Pinterest account through the API, and use the board id to publish pins, with no Pinterest OAuth to build.
Publish YouTube ShortsPublish YouTube Shorts to your customer's channel through the API, with title, privacy, category and tags, with no Google OAuth to build.
Track the status of a publicationSee whether a post was published, failed or is still queued: read GET /posts/{uuid} or list with GET /posts and filters by status and external_reference.
Upload large videos to use in postsUpload videos of up to 1 GB in parts through the API and get a public URL to use in Instagram, Facebook, YouTube and other network posts.
List posts across all customersSee the posts of all your merchant's customers in a single call, with only the Bearer token, and filter by customer, connection or status.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
