PowerPost APIv1
PowerPost APIv1
PowerPost APIQuickstartAuthenticationWorkspacesInput Types

API Reference

Upload MediaGenerate ContentGenerationsGenerate ImagesPosts & PublishingGet Credits

Guides

WebhooksError CodesChangelog

Quickstart

Generate captions, create images, and publish — in under 5 minutes.

Go from idea to published social media post in 5 minutes.

Prerequisites

  • A PowerPost account with credits
  • An API key (create one in Settings → API)
  • Connected social accounts for publishing (in Settings → Connections)

Step 1: Get Your API Key

  1. Go to Settings → API in your PowerPost dashboard
  2. Click Create API Key
  3. Copy the key — you'll only see it once!

Your key looks like: pp_live_sk_abc123...

Step 2: Generate Captions

curl -X POST https://powerpost.ai/api/v1/content/generate \
  -H "x-api-key: pp_live_sk_YOUR_KEY_HERE" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "We just launched dark mode for our app",
    "post_types": ["tiktok-video", "instagram-reel"],
    "research_mode": "regular"
  }'

Response:

{
  "generation_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "credits_used": 10,
  "remaining_credits": 90,
  "status_url": "/api/v1/content/generations/550e8400-e29b-41d4-a716-446655440000"
}

Step 3: Poll for Results

Content generation takes a few seconds. Poll until status is completed:

curl https://powerpost.ai/api/v1/content/generations/550e8400-e29b-41d4-a716-446655440000 \
  -H "x-api-key: pp_live_sk_YOUR_KEY_HERE" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_ID"
{
  "generation_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "prompt": "We just launched dark mode for our app",
  "platforms": ["tiktok", "instagram"],
  "research_mode": "regular",
  "credits_used": 10,
  "created_at": "2026-01-10T18:30:00Z",
  "outputs": {
    "tiktok": "🌙 Dark mode activated! POV: your eyes at 2am finally getting some relief... #darkmode #productupdate #tech",
    "instagram": "✨ Dark mode is here!\n\nYour late-night scrolling just got easier on the eyes... #DarkMode #AppUpdate"
  }
}

Step 4: Generate an Image (Optional)

Create an image to go with your captions:

curl -X POST https://powerpost.ai/api/v1/images/generate \
  -H "x-api-key: pp_live_sk_YOUR_KEY_HERE" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "generation_id": "550e8400-e29b-41d4-a716-446655440000",
    "size": "portrait",
    "quantity": 1
  }'

Response:

{
  "image_generation_id": "7a8b9c0d-e1f2-3456-abcd-ef7890123456",
  "status": "processing",
  "credits_used": 9,
  "remaining_credits": 81,
  "status_url": "/api/v1/images/generations/7a8b9c0d-e1f2-3456-abcd-ef7890123456"
}

Poll for the generated image:

curl https://powerpost.ai/api/v1/images/generations/7a8b9c0d-e1f2-3456-abcd-ef7890123456 \
  -H "x-api-key: pp_live_sk_YOUR_KEY_HERE" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_ID"

Step 5: Create a Post

Combine captions and images into a post:

curl -X POST https://powerpost.ai/api/v1/posts \
  -H "x-api-key: pp_live_sk_YOUR_KEY_HERE" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "generation_id": "550e8400-e29b-41d4-a716-446655440000",
    "items": [
      {
        "post_type": "instagram-reel",
        "media_ids": ["img-001-abcd-efgh"]
      },
      {
        "post_type": "tiktok-video",
        "media_ids": ["img-001-abcd-efgh"]
      }
    ]
  }'

Step 6: Publish

curl -X POST https://powerpost.ai/api/v1/posts/post-550e8400-e29b-41d4-a716-446655440000/publish \
  -H "x-api-key: pp_live_sk_YOUR_KEY_HERE" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_ID"

That's it — your content is live on Instagram and TikTok.

Next Steps

  • Upload Media — Upload images and videos
  • Input Types — Generate from text, images, or video
  • Authentication — API key details and security
  • Generate Endpoint — Full request options
  • Webhooks — Get notified when jobs complete

PowerPost API

Generate captions, create images, and publish to social platforms — all from one API.

Authentication

How to authenticate with the PowerPost API using API keys.

On this page

PrerequisitesStep 1: Get Your API KeyStep 2: Generate CaptionsStep 3: Poll for ResultsStep 4: Generate an Image (Optional)Step 5: Create a PostStep 6: PublishNext Steps