API keys and the Cue API
Create, schedule and publish posts from your own scripts or tools, using an API key.
Create a key
Open Settings → API keys (Admins only).
Name the key after what will use it, then click Create key.

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.
| Endpoint | Does |
|---|---|
GET /clients | Lists clients and their connected accounts (use the account ids when posting). |
POST /media/presign | Gives a short-lived link to upload a file, then you PUT the file to it. |
POST /posts | Creates a post. action is draft, schedule or now. |
GET /posts/:id | A post and the status of each account. |
GET /posts?clientId=&status=&limit= | Lists posts (up to 100). |
DELETE /posts/:id | Deletes a draft or scheduled 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
| Code | Means |
|---|---|
| 400 | Something in the request is invalid. The error and details fields say what. |
| 401 | Missing, wrong or revoked key. |
| 403 | Refused: workspace suspended, API switched off for it, or a plan limit reached. |
| 404 | Not found (or belongs to another workspace). |
| 409 | The post can't do that now, e.g. deleting a published post. |
| 503 | now while publishing is paused. Schedule it instead. |
Related guides
Something here wrong or unclear? Email karan@trycue.space.