REST API

Fuxux's REST API: API keys, the main endpoints for posts, accounts and media, signed webhooks and rate limits.

The REST API covers what the web app does with posts: create, schedule, list, edit and delete them, upload media, read connected accounts and analytics, and generate captions. The interactive reference is at /reference and the OpenAPI document at /openapi.json.

Using Cursor, Claude Code or another coding assistant with the Context7 MCP server? These docs are indexed there: add use context7 to your prompt, or ask for the library /llmstxt/fuxux_llms_txt (Fuxux on Context7). The API reference is indexed too, as Fuxux API.

Base URL and authentication

https://www.fuxux.com/api

Send an API key as a bearer token. Keys need a paid plan with the API add-on ($5/month, from the Billing page). Create them on the API keys page: they start with fx_live_, are shown once and last until you revoke or rotate them. Use one key per integration.

curl https://www.fuxux.com/api/accounts \
  -H "Authorization: Bearer fx_live_your_key_here"

Main endpoints

Method and path	What it does
`GET /api/accounts`	List connected social accounts.
`GET /api/posts`	List posts (filter by status and month).
`POST /api/posts`	Create a post: publish now, schedule or save a draft.
`GET /api/posts/{id}`	One post with per-platform results.
`PATCH /api/posts/{id}`	Edit or reschedule a draft or scheduled post.
`DELETE /api/posts/{id}`	Delete a post.
`POST /api/media/upload`	Upload an image or video to attach to posts.
`POST /api/ai/generate`	Generate a caption for each platform from a prompt.
`GET /api/usage`	Your plan's limits and what you've used this month.
`GET /api/analytics`	Publishing analytics.
`GET /api/dashboard`	Summary: counts, upcoming posts, accounts needing attention.

Create a post

curl -X POST https://www.fuxux.com/api/posts \
  -H "Authorization: Bearer fx_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "captions": {
      "linkedin": "We just shipped RSS auto-posting: every new blog post now shares itself.",
      "bluesky": "RSS auto-posting is live."
    },
    "scheduled_at": "2026-11-02T09:00:00Z"
  }'

captions maps each platform id to its caption; the post goes to the first connected account on each platform, or to the accounts you list in targets. Leave out scheduled_at to publish now, or send draft: true to save a draft. Attach media with media_urls from POST /api/media/upload. All fields are in the API reference.

Webhooks

Set a webhook URL on the API keys page to get a POST when a post publishes or fails. Each request is signed: the X-Fuxux-Signature header is sha256= followed by the HMAC-SHA256 of the raw body with your webhook secret. Check it before trusting the payload.

Rate limits and errors

120 requests a minute per key, 300 a minute per account across all keys. A 429 response says when to retry.
Errors return JSON with an error message that explains what to change (for example a caption over a network's limit, or a plan limit reached).

View as Markdown