Skip to main content

Quick Start

Get your first cross-platform post scheduled in under 5 minutes.

Prerequisites​

  • A PostEverywhere account (14-day free trial, no credit card required)
  • At least one connected social media account (connect via the dashboard)
  • An API key (generate in Settings > Developers)

Step 1: Get Your API Key​

Navigate to Settings > Developers in your PostEverywhere dashboard and click Generate API Key.

Your key starts with pe_live_ — keep it secret.

export POSTEVERYWHERE_API_KEY="pe_live_abc123..."

Step 2: List Your Connected Accounts​

curl https://app.posteverywhere.ai/api/v1/accounts \
  -H "Authorization: Bearer $POSTEVERYWHERE_API_KEY"

Response:

{
  "data": {
    "accounts": [
      {
        "id": 2280,
        "platform": "instagram",
        "account_name": "mybrand",
        "avatar_url": "https://...",
        "is_active": true
      }
    ]
  }
}

Note the id values (integers) — you'll use these in account_ids when creating posts.

Step 3: Create a Post​

curl -X POST https://app.posteverywhere.ai/api/v1/posts \
  -H "Authorization: Bearer $POSTEVERYWHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Exciting news! We just launched our API.",
    "account_ids": [2280, 2281],
    "scheduled_for": "2026-04-01T10:00:00Z"
  }'

Response:

{
  "data": {
    "post_id": "d3e859bf-8b9e-4cd8-99e5-7f019ab95709",
    "content": "Exciting news! We just launched our API.",
    "status": "scheduled",
    "scheduled_for": "2026-04-01T10:00:00Z",
    "account_ids": [2280, 2281],
    "destinations": [
      {
        "platform": "instagram",
        "account_id": 2280,
        "account_name": "mybrand",
        "status": "scheduled"
      },
      {
        "platform": "linkedin",
        "account_id": 2281,
        "account_name": "My Brand Inc.",
        "status": "scheduled"
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": "req_a1b2c3d4",
    "timestamp": "2026-04-01T09:55:12.341Z"
  }
}

Notice that every field name in your request (content, account_ids, scheduled_for) also appears in the response with the same name and same meaning — this is the round-trip principle. You can take the response and POST its top-level fields straight back to create a clone.

Step 4: Check Results​

After the scheduled time, check how your post performed:

curl https://app.posteverywhere.ai/api/v1/posts/post_789/results \
  -H "Authorization: Bearer $POSTEVERYWHERE_API_KEY"

Next Steps​