Help/Settings

API keys and the Cue API

Create, schedule and publish posts from your own scripts or tools, using an API key.

Create a key

  1. Open Settings → API keys (Admins only).

  2. Name the key after what will use it, then click Create key.

    Settings, API keys: a name field and the Create key button.
  3. Copy the key straight away and store it somewhere safe. It's shown only once. Then click I've saved it.

  • A key acts as the Admin who created it, in this workspace.
  • Revoke stops a key immediately. Anything using it stops working.
  • Lost a key? Revoke it and create a new one. Keys can't be shown again.

Use the API

The API lives at https://trycue.space/api/v1. Send the key on every request as Authorization: Bearer cue_…. Everything is JSON.

EndpointDoes
GET /clientsLists clients and their connected accounts (use the account ids when posting).
POST /media/presignGives a short-lived link to upload a file, then you PUT the file to it.
POST /postsCreates a post. action is draft, schedule or now.
GET /posts/:idA post and the status of each account.
GET /posts?clientId=&status=&limit=Lists posts (up to 100).
DELETE /posts/:idDeletes a draft or scheduled post.
Schedule a post
curl -X POST https://trycue.space/api/v1/posts \
  -H "Authorization: Bearer $CUE_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-post-001" \
  -d '{
    "clientId": "cmg…",
    "accountIds": ["cmh…"],
    "body": "We're live!",
    "scheduledAt": "2026-12-01T09:00:00+05:30",
    "action": "schedule"
  }'

Error codes

CodeMeans
400Something in the request is invalid. The error and details fields say what.
401Missing, wrong or revoked key.
403Refused: workspace suspended, API switched off for it, or a plan limit reached.
404Not found (or belongs to another workspace).
409The post can't do that now, e.g. deleting a published post.
503now while publishing is paused. Schedule it instead.

Something here wrong or unclear? Email karan@trycue.space.