التوثيق / API / Plan a post

Plan a post

Put a social post on the calendar — one idea, written for every channel you name.

قراءة 5 دقائق Paid plans

POST /api/v1/posts

A post is one idea across several channels. Send one topic and the channels it should reach; QuQi writes each channel its own version in that network's style, and they publish and fail separately.

ابدأ من هنا This puts the post on the calendar and answers 202. It is written as its slot approaches — usually within a minute — not while you wait. The reply's what_happens says exactly what will become of it.

topic string مطلوب

What the post is about, in your own words.

website_id string مطلوب

Which of your websites. Not needed if your key is narrowed to one.

channels array اختياري

Which channels to write for. Leave it out to use every connected channel.

brief string اختياري

Anything the post must cover, mention or avoid.

image_prompt string اختياري

What the picture should SHOW — the subject, in plain words. Required for channels that cannot post text.

scheduled_at string اختياري

When it should go out. Defaults to an hour from now. Cannot be in the past.

post_type string اختياري

One of promotional, engagement, conversion, educational, proof, product.

mode string اختياري

How far it goes on its own. Defaults to draft.

How far it goes on its own

mode decides what happens once the post is written. It defaults to draft, because a program has nobody to answer an approval message — nothing you send this way goes public unless you ask.

MODEWHAT HAPPENSGOES PUBLIC?

draft Written, and waits on your calendar. No — the default

approval Written; you get a link. Silence means no. Only if you say so

unless_stopped Written and put on the clock. Silence means yes. Yes, at its slot

publish Written and sent. You are not asked. Yes

انتبه unless_stopped and publish put your post in front of the public without anyone reading it first. Use them once you trust what QuQi writes for you.

What it refuses

Each of these would otherwise be accepted and then quietly never arrive.

CODEWHYWHAT TO DO

media_required Instagram, TikTok and Pinterest have no text posts. Send an image_prompt, or drop those channels.

slot_in_the_past A post is written as its slot approaches. Send a time in the future.

plan_limit_reached No posts left this period. The reply carries the reset date. Nothing was saved.

no_channels Nothing connected, and none named. Connect a channel, or name one.

معلومة مفيدة A channel with no account connected is accepted — planning ahead of connecting is reasonable — but comes back in will_not_write_until_connected. Those are never written until you connect it.

CURL

curl -X POST https://console.quqi.io/api/v1/posts \
  -H "Authorization: Bearer quqi_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "website_id": "019feda8-0ca6-70d1-b927-697fa6650cda",
    "topic": "Why used-car buyers get declined",
    "channels": ["linkedin", "instagram"],
    "image_prompt": "a mechanic handing over keys"
  }'

RESPONSE 202

{
  "success": true,
  "data": {
    "id": "01a0585d-5755-72bd-a022-c6d6c59a7e0a",
    "status": "planned",
    "mode": "draft",
    "channels": [
      { "channel": "linkedin", "status": "planned", "connected": true },
      { "channel": "instagram", "status": "planned", "connected": true }
    ],
    "what_happens": "It is written as its slot approaches and waits as a draft. Nothing goes out on its own."
  }
}

REFUSED 422

{
  "success": false,
  "error": {
    "code": "media_required",
    "message": "Instagram cannot publish text on its own. Send an image_prompt, or drop that channel.",
    "details": { "channels": ["instagram"] }
  }
}

هل أجابت هذه الصفحة عن سؤالك؟ نعم ليس تمامًا

One channel

List posts