Plan a post

Have the Social Copywriter write a post — one idea, written for every channel you name.

5 min de lectura 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.

EMPIECE AQUÍ This answers 202 straight away, and the Social Copywriter starts writing the post — it takes a minute or two, not while you wait. Read it back, or subscribe to webhooks, for the result.

topic string OBLIGATORIO

What the post is about, in your own words.

website_id string OBLIGATORIO

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

channels array OPCIONAL

Which channels to write for. Leave it out to use every connected channel except YouTube, which takes only a video: a post filed here carries a picture at most.

brief string OPCIONAL

Anything the post must cover, mention or avoid.

image_prompt string OPCIONAL

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

scheduled_at string OPCIONAL

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

post_type string OPCIONAL

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

mode string OPCIONAL

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, so nothing you send this way goes public unless you ask.

MODEWHAT HAPPENSGOES PUBLIC?

draft Written, then waits for the owner’s OK in an approval box in the Social Copywriter’s chat. Only once approved — the default

approval, unless_stopped The same as draft: written, then waits for the owner’s OK. Only once approved

publish Written, then goes out at its slot if Social posts is on in the website’s Approvals when it is ready. If it is off, it waits for the OK like the others. Yes, if Social posts is on

OJO publish on a website with Social posts on puts your post in front of the public without anyone reading it first. Use it 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. YouTube takes only a video, and a post filed here carries a picture at most. Send an image_prompt, or drop those channels. For YouTube, drop it: a picture does not help.

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.

CONVIENE SABER 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": "writing", "connected": true },
      { "channel": "instagram", "status": "writing", "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": "YouTube takes only a video, and a post filed here carries a picture at most. Drop that channel. Instagram cannot publish text on its own. Send an image_prompt, or drop that channel.",
    "details": { "channels": ["instagram", "youtube"] }
  }
}

¿Esta página ha respondido a su pregunta? Sí No del todo

One channel

List posts