Publora Instagram

Post or schedule content to Instagram using the Publora API. Use this skill when the user wants to publish images, reels, stories, or carousels to Instagram via Publora.

Sergey Bulaev@sergebulaev

Install

openclaw skills install @sergebulaev/publora-instagram

Publora — Instagram

Instagram platform skill for the Publora API. For auth, core scheduling, media upload, and workspace/webhook docs, see the publora core skill.

Base URL: https://api.publora.com/api/v1
Header: x-publora-key: sk_YOUR_KEY
Platform ID format: instagram-{accountId}

Requirements

Instagram Business account recommended — personal accounts are not supported; Creator accounts may also work (instagram_business_* scopes), but Business is the officially tested and recommended type
Connected directly via Instagram OAuth through the Publora dashboard (no Facebook Page required)

Platform Limits (API)

⚠️ Instagram API is significantly more restrictive than the native app.

Property	API Limit	Native App
Caption	2,200 characters	2,200
Images	10 × 8 MB	20 images
Image format	JPEG recommended via API (PNG may work in practice; GIF not supported)	PNG, GIF also work
Mixed carousel	❌ No images + videos	✅
Reels duration	3 min (180s) via API ⚠️	20 minutes
Reels size	300 MB	—
Stories duration	60s / 100 MB	—
Carousel video	60s per clip / 300 MB	—
Text only	❌ Media required	—
Rate limit	50 posts/24hr	—

First 125 characters visible before "more".

Common errors:

(#10) The user is not an Instagram Business — Creator accounts not supported, switch to Business
Error 2207010 — caption exceeds 2,200 chars
Error 2207004 — image exceeds 8 MB
Error 9, Subcode 2207042 — rate limit reached

Post an Image

javascript

// Step 1: Create the post
const post = await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    content: 'Your caption here ✨ #hashtag',
    platforms: ['instagram-17841412345678'],
    scheduledTime: '2026-03-20T12:00:00.000Z'
  })
}).then(r => r.json());

// Step 2: Get upload URL
const upload = await fetch('https://api.publora.com/api/v1/get-upload-url', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    postGroupId: post.postGroupId,
    fileName: 'photo.jpg',
    contentType: 'image/jpeg',   // ⚠️ JPEG only for Instagram
    type: 'image'
  })
}).then(r => r.json());

// Step 3: Upload to S3
await fetch(upload.uploadUrl, {
  method: 'PUT',
  headers: { 'Content-Type': 'image/jpeg' },
  body: imageFileBytes
});

Post a Carousel (up to 10 images)

Call get-upload-url N times with the same postGroupId:

python

import requests

HEADERS = { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' }

# Create post
post = requests.post('https://api.publora.com/api/v1/create-post', headers=HEADERS, json={
    'content': 'Swipe through our product highlights! 👆',
    'platforms': ['instagram-17841412345678'],
    'scheduledTime': '2026-03-20T12:00:00.000Z'
}).json()

# Upload each image (max 10)
images = ['slide1.jpg', 'slide2.jpg', 'slide3.jpg']
for img_path in images:
    upload = requests.post('https://api.publora.com/api/v1/get-upload-url', headers=HEADERS, json={
        'postGroupId': post['postGroupId'],
        'fileName': img_path,
        'contentType': 'image/jpeg',
        'type': 'image'
    }).json()
    with open(img_path, 'rb') as f:
        requests.put(upload['uploadUrl'], headers={'Content-Type': 'image/jpeg'}, data=f)

Post a Reel (video, up to 3 min via API)