Quegly API Documentation

Base URL

All API requests should be made to the following base URL:

https://api.quegly.com/v1

All API requests require an API key passed via the Authorization header. Generate an API key from Dashboard → Settings → API. Both bare and Bearer-prefixed forms are accepted.

curl https://api.quegly.com/v1/accounts \
  -H "Authorization: qgl_your_api_key"

# Bearer prefix is also accepted:
curl https://api.quegly.com/v1/accounts \
  -H "Authorization: Bearer qgl_your_api_key"

API Key Scopes

Each API key has a scope that controls which workspaces it can act on. You choose the scope when generating the key.

curl https://api.quegly.com/v1/accounts \
  -H "Authorization: qgl_your_all_scope_key" \
  -H "X-Workspace-Id: workspace-uuid"

Don't know your workspace IDs? Call GET /v1/workspaces to list them, then use the id you want as X-Workspace-Id.

You can generate up to 10 keys per account, with multiple keys per scope. Useful for rotating keys without downtime, or scoping integrations (one key for Zapier, one for n8n, etc.).

The API uses a token-bucket limiter. Each key has its own budget. Keys on the same account don't share counters. Limits scale with your plan:

The older Creator and Agency plans keep their limits: 60 and 300 a minute.

You can target multiple platforms in a single Create Post request to stay well under the limit. Posting has no daily cap, except on X: each X account takes up to 5 posts a day, as the X API is metered. Posts can be scheduled up to 90 days in advance.

Supported Platforms

Quegly supports posting to 10 social media platforms. Each platform has specific media requirements and optional settings. See the Platform Settings section for per-platform details.

Instagram

Feed posts, carousels, Reels

Facebook

Posts, photos, videos

YouTube

Videos, Shorts

TikTok

Videos, Photo Mode slideshows

X (Twitter)

Tweets with images or video

Threads

Text posts, images, video, carousels

LinkedIn

Profile posts, images, video, carousels

Bluesky

Text posts, images, video, link cards

Pinterest

Photo, carousel and video Pins on a board

Telegram

Channel and group posts, photo albums, video

Terminology

Quick Start

Here's a complete example that uploads an image and schedules a post to Instagram and TikTok:

Step 1: Upload your media

curl -X POST https://api.quegly.com/v1/upload \
  -H "Authorization: qgl_your_api_key" \
  -F "file=@/path/to/image.jpg"

Step 2: Create a scheduled post

curl -X POST https://api.quegly.com/v1/posts \
  -H "Authorization: qgl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schedule",
    "scheduled_at": "2026-06-01T14:00:00.000Z",
    "caption": "Check out this amazing room transformation!",
    "media_ids": ["media-id-from-step-1"],
    "account_ids": ["instagram-account-id", "tiktok-account-id"],
    "platform_settings": {
      "tiktok": {
        "privacy_level": "PUBLIC_TO_EVERYONE",
        "allow_comment": true,
        "allow_duet": true,
        "allow_stitch": true
      }
    }
  }'

Error Handling

The API uses standard HTTP status codes and returns errors as JSON. The code is stable and safe to pattern-match on; the message is human-readable and may evolve.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "TikTok requires a privacy_level setting",
    "field": "platform_settings.tiktok.privacy_level"
  }
}

Paused accounts. Each plan includes a number of channels (connected accounts). When an owner has more than their plan includes, after moving to a smaller plan for example, their newest accounts past that number are paused: creating or updating a post that goes to one returns 400 CHANNEL_PAUSED naming the account, and its scheduled posts fail when they come due. Disconnecting an account on the Manage page, or moving to a bigger plan, unpauses them at once.