Drive Campaign Desk from your own code

{
 "task": "plan",
 "campaign": "Quorvane launch",
 "product": "Quorvane - invoice capture and approval automation for mid-size finance teams",
 "goal": "launch",
 "brief": "{\"objective\":\"Generate 400 demo requests from finance teams at 50-500 person companies between the launch on 2026-10-20 and ..."
}

{
 "objective": "Generate 400 demo requests from finance teams at 50-500 person companies between the launch on 2026-10-20 and 2026-11-20.",
 "audience": "Finance operations managers and controllers at 50-500 person companies who still key supplier invoices by hand and chase approvals over email at month end.",
 "key_message": "Close the month without chasing a single invoice: Quorvane reads, codes and routes supplier invoices for approval on its own.",
 "brand_voice": "Confident and practical, written for finance people: concrete numbers, no hype, short sentences.",
 "landing_url": "https://quorvane.example.com/launch",
 "utm_campaign": "quorvane-launch",
 "facts": [
  {
   "id": "N1",
   "text": "In a 14-customer pilot, invoice processing time fell by 62% on average."
  },
  {
   "id": "N2",
   "text": "Pilot customers approved 91% of invoices within 48 hours, against 54% before."
  },
  "... 4 more"
 ],
 "kpis": [
  {
   "id": "K1",
   "name": "Demo requests",
   "target": "400",
   "target_num": 400
  },
  {
   "id": "K2",
   "name": "Landing page conversion rate",
   "target": "6%",
   "target_num": 6
  },
  {
   "id": "K3",
   "name": "Paid search cost per demo",
   "target": "$45",
   "target_num": 45
  }
 ],
 "channels": [
  {
   "id": "landing",
   "label": "Landing page"
  },
  {
   "id": "blog",
   "label": "Blog"
  },
  {
   "id": "email",
   "label": "Email"
  },
  {
   "id": "linkedin",
   "label": "LinkedIn"
  },
  {
   "id": "paid_search",
   "label": "Paid search"
  }
 ],
 "dates": {
  "start": "2026-10-05",
  "launch": "2026-10-20",
  "launch_weekday": "Tuesday",
  "end": "2026-11-20",
  "prelaunch_business_days": 11,
  "total_business_days": 35,
  "weeks": 7
 },
 "budget": 18000,
 "pacing": {
  "total": 18000,
  "weeks": 7,
  "per_week": 2571.43,
  "paid_business_days": 24,
  "per_paid_day": 750
 },
 "calendar": [
  {
   "id": "C1",
   "date": "2026-10-05",
   "weekday": "Monday",
   "week": 1,
   "phase": "pre",
   "channel": "ops",
   "asset": "Campaign brief signed off",
   "purpose": "Owners, approvals and the tracking plan agreed before anything is made.",
   "depends_on": []
  },
  {
   "id": "C2",
   "date": "2026-10-05",
   "weekday": "Monday",
   "week": 1,
   "phase": "pre",
   "channel": "linkedin",
   "asset": "Teaser post",
   "purpose": "Tease the problem or the date.",
   "depends_on": []
  },
  {
   "id": "C3",
   "date": "2026-10-12",
   "weekday": "Monday",
   "week": 2,
   "phase": "pre",
   "channel": "landing",
   "asset": "Landing page live",
   "purpose": "The destination every link points to; conversion event and UTMs tested before the first send.",
   "depends_on": []
  },
  "... 19 more"
 ],
 "prescan_flags": []
}

{
 "lane": "plan",
 "headline": "Quorvane's launch campaign targets finance operations managers and controllers at 50-500 person companies to generate 400 demo requests between the 2026-10-20 ...",
 "summary": "The campaign leads with the pain finance teams already feel at month end - keying invoices by hand and chasing approvals over email - and proves the fix with pilot ...",
 "objectives": [
  {
   "text": "Generate 400 demo requests from finance teams at 50-500 person companies between the 2026-10-20 launch and the 2026-11-20 close.",
   "kpi_ref": "K1",
   "target": "400",
   "by": "2026-11-20"
  },
  {
   "text": "Convert landing page visitors into demo requests at a 6% rate across the campaign.",
   "kpi_ref": "K2",
   "target": "6%",
   "by": "2026-11-20"
  },
  "... 1 more"
 ],
 "audience": {
  "primary": "Finance operations managers and controllers at 50-500 person companies who still key supplier invoices by hand and chase approvals over email at month end.",
  "secondary": "",
  "pains": [
   "Keying supplier invoice data by hand takes time away from higher-value work.",
   "Chasing colleagues over email for invoice approvals, especially at month end.",
   "... 1 more"
  ],
  "motivations": [
   "Close the month without manually chasing invoices.",
   "Free up time currently spent on manual data entry.",
   "... 1 more"
  ],
  "where": [
   "Landing page",
   "Blog",
   "... 3 more"
  ]
 },
 "messaging": {
  "core": "Close the month without chasing a single invoice: Quorvane reads, codes and routes supplier invoices for approval on its own.",
  "pillars": [
   {
    "name": "Faster processing",
    "text": "In a 14-customer pilot, invoice processing time fell by 62% on average.",
    "proof_ref": "N1"
   },
   {
    "name": "Faster approvals",
    "text": "Pilot customers approved 91% of invoices within 48 hours, against 54% before.",
    "proof_ref": "N2"
   },
   "... 2 more"
  ],
  "proof_gaps": [
   "No case study or named customer yet to attach to the pilot results.",
   "No proof point in dollar savings, only processing time and approval-rate figures."
  ]
 },
 "channels": [
  {
   "channel": "landing",
   "role": "The single destination every link drives to; takes and converts demo requests.",
   "why": "Landing page conversion rate is K2, so this is where the message has to close.",
   "cadence": "Live from 2026-10-12 (C3), running through the campaign close on 2026-11-20."
  },
  {
   "channel": "blog",
   "role": "Frames the problem before launch, hosts the canonical launch announcement, and adds proof depth afterward.",
   "why": "Carries the fuller argument that shorter formats can't, and other channels link back to it.",
   "cadence": "Teaser 2026-10-13 (C5); launch post 2026-10-20 (C8); proof posts 2026-11-02 and 2026-11-16 (C14, C18)."
  },
  "... 3 more"
 ],
 "calendar": [
  {
   "ref": "C1",
   "title": "Campaign brief sign-off",
   "angle": "Owners, approvals and the tracking plan for the Quorvane launch agreed before anything is built.",
   "cta": "Sign-off from marketing, sales and product on scope, owners and tracking plan.",
   "owner": "campaign lead"
  },
  {
   "ref": "C2",
   "title": "Teaser: the month-end chase",
   "angle": "Hints at the pain of chasing invoice approvals over email at month end, without naming the product.",
   "cta": "Follow for what's coming.",
   "owner": "content lead"
  },
  "... 20 more"
 ],
 "metrics": [
  {
   "kpi_ref": "K1",
   "name": "Demo requests",
   "target": "400",
   "type": "lagging",
   "source": "Demo request form submissions on the landing page, by utm_campaign=quorvane-launch."
  },
  {
   "kpi_ref": "K2",
   "name": "Landing page conversion rate",
   "target": "6%",
   "type": "lagging",
   "source": "Landing page analytics: demo requests divided by visits."
  },
  "... 3 more"
 ],
 "budget": {
  "summary": "The full $18,000 budget funds the paid search flight, paced at about $750 across each of the 24 business days the flight runs, to stay near the $45 cost-per-demo target; ...",
  "lines": [
   {
    "item": "Paid search media spend",
    "amount": 18000,
    "why": "Paces the full budget across the 24 business days of the flight (2026-10-20 to 2026-11-20) at $750/day, in service of the $45 cost-per-demo target (K3)."
   }
  ]
 },
 "risks": [
  {
   "risk": "The landing page (C3) is the dependency for the launch post, launch email and paid search flight; if it slips, C8, C9 and C11 all slip with it.",
   "mitigation": "Build and QA the landing page by 2026-10-12, a full week ahead of the 2026-10-20 launch, so there is slack before the dependent items."
  },
  {
   "risk": "Proof rests on one 14-customer pilot (N1, N2), with no named customer or case study yet.",
   "mitigation": "Lead with the aggregate pilot numbers rather than a named customer, and treat securing a citable case study as a priority for the sustain phase."
  },
  "... 2 more"
 ],
 "prescan_responses": []
}

{
 "task": "draft",
 "campaign": "Quorvane launch",
 "product": "Quorvane - invoice capture and approval automation for mid-size finance teams",
 "goal": "launch",
 "item": "{\"id\":\"C9\",\"date\":\"2026-10-20\",\"weekday\":\"Tuesday\",\"phase\":\"launch\",\"channel\":\"email\",\"channel_label\":\"Email\",\"asset\":\"Launch email\",\"purpose\":\"Announce to the list and drive to the landing page.\",\"link\":\"https://quorvane.example.com/launch?utm_source=newsletter&utm_medium=email&utm_campaign=quorvane-launch&utm_content=c9-launch-email\",\"limits\":[{\"field\":\"headline_options\",\"label\":\"Subject line\",\"hard\":false,\"max\":60},{\"field\":\"preheader\",\"label\":\"Preheader\",\"hard\":false,\"max\":100},{\"field\":\"body\",\"label\":\"Body\",\"hard\":false,\"minWords\":60,\"maxWords\":250}]}",
 "brief": "{\"objective\":\"Generate 400 demo requests from finance teams at 50-500 person companies between the launch on 2026-10-20 and ..."
}

{
 "lane": "draft",
 "ref": "C9",
 "channel": "email",
 "asset": "Launch email",
 "headline_options": [
  "Quorvane is live: stop chasing invoices",
  "Invoices read, coded and routed automatically",
  "... 2 more"
 ],
 "body": "Hi there,\n\nEvery month end, your team keys supplier invoices by hand and chases approvals over email. Quorvane is live today, and it changes that: it reads, codes and routes supplier invoices for approval on its own, so your close is not held up by a stack ...",
 "posts": [],
 "headlines": [],
 "descriptions": [],
 "preheader": "Quorvane cut invoice processing time 62% in a 14-customer pilot. Free 30-day trial, no card.",
 "meta_title": "",
 "meta_description": "",
 "hashtags": [],
 "cta": "Start your free 30-day trial",
 "claims": [
  {
   "text": "In a 14-customer pilot, invoice processing time fell by 62% on average",
   "ref": "N1"
  },
  {
   "text": "Pilot customers approved 91% of invoices within 48 hours, up from 54% before Quorvane",
   "ref": "N2"
  },
  "... 4 more"
 ],
 "notes": [
  "Subject lines split between a relief angle (\"stop chasing invoices\") and a result angle (62% faster); A/B test the two.",
  "Greeting uses \"Hi there\" - swap in a first-name merge tag if the list has one.",
  "... 1 more"
 ],
 "prescan_responses": []
}

{
 "ref": "C6",
 "channel": "x",
 "posts": [
  "Three outages. In each one, the signal was already there - nobody was watching it. We're taking them apart live, and showing exactly what a platform engineer would have caught, and when.",
  "No highlight reel, no pitch. Engineer to engineer, on incidents that actually happened - what we'd have alerted on, and how much sooner.",
  "If you carry the pager, this one's for you. Register for the live session: https://pingfold.example.com/webinar/api-outage-autopsy?utm_source=x&utm_medium=social&utm_campaign=api-outage-autopsy-webinar&utm_content=c6-launch-day-thread"
 ],
 "hashtags": [],
 "cta": "Register for the webinar",
 "claims": [],
 "prescan_responses": [
  {
   "id": "P6",
   "status": "confirmed",
   "reason": "No facts were provided, so this draft avoids stats, customers or results and only repeats the outage count already given in the key message."
  },
  "... 1 more"
 ]
}

{ "ok": true,  "data":  { ... } }
{ "ok": false, "error": { "code": "...", "message": "...", "status": 402, "details": { ... } } }

# The token page is the shortest path. It shows the token this browser holds and
# hands you a ready-made shell export:
#
#   https://campaign-desk.skillsafe.ai/tokens.html
#   export SKILLSAFE_TOKEN="..."
#
# To mint a guest token from the command line instead. A guest token is enough
# for /me and /estimate; both lanes (plan and draft) need a personal token
# from signing in.
curl -sS -X POST "https://api.skillsafe.ai/v1/app-api/guest" \
  -H "Content-Type: application/json" -d '{"slug":"campaign-desk"}'
# {"ok":true,"data":{"token":"…","subject_type":"guest"}}

# Every call is the same three things: the base URL, your bearer token,
# and a JSON body. Keep the token in a shell variable.
BASE="https://api.skillsafe.ai/v1/app-api"
SLUG="campaign-desk"
TOKEN="$SKILLSAFE_TOKEN"   # from https://campaign-desk.skillsafe.ai/tokens.html

call() {                  # call <path> [json-body]
  if [ -n "$2" ]; then
    curl -sS -X POST "$BASE/$1" \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json" \
      -d "$2"
  else
    curl -sS "$BASE/$1" -H "Authorization: Bearer $TOKEN"
  fi
}

call me
# {"ok":true,"data":{"subject_type":"user","username":"you","credits":51234}}

# body.json is the input object itself - no {"input": ...} wrapper. Build it with
# make-body.js below. estimate does not validate it, so check the shape first:
python3 -c 'import json;b=json.load(open("body.json"));assert isinstance(b,dict) and b.get("task") in ("plan","draft") and all(isinstance(v,str) for v in b.values()) and all(b.get(k,"").strip() for k in ("campaign","product","goal","brief")) and isinstance(json.loads(b["brief"]),dict) and (b["task"]=="plan" or isinstance(json.loads(b.get("item","null")),dict))'
INPUT=$(cat body.json)
LANE=$(printf '%s' "$INPUT" | python3 -c 'import sys,json;print(json.load(sys.stdin)["task"])')

call estimate "$INPUT"
# {"ok":true,"data":{"model":"gpt-5.6-terra","model_alias":"gpt-terra",
#   "markup_bps":1000,"hold_credits":...,"min_credits":...,"sponsor_enabled":false,
#   "input_checked":true,"warnings":[]}}
#
# estimate creates no job and charges nothing. hold_credits is RESERVED, not the
# price; charged_credits after the run is usually far lower.

// make-body.js - build the run body with the SAME engine the web page uses.
// Save campaignkit.js from https://campaign-desk.skillsafe.ai/campaignkit.js next to this file.
const fs = require("fs");
const K = require("./campaignkit.js");

const A = K.analyze({
  name: "Quorvane launch",
  product: "Quorvane - invoice capture and approval automation for mid-size finance teams",
  goal: "launch",                                  // launch | leadgen | awareness | event
  objective: "Generate 400 demo requests from finance teams at 50-500 person companies between the launch on 2026-10-20 and 2026-11-20.",
  audience: "Finance operations managers and controllers at 50-500 person companies ...",
  message: "Close the month without chasing a single invoice: ...",
  facts: fs.readFileSync("facts.txt", "utf8"),     // one proof point per line -> N1, N2, ...
  kpis: "Demo requests: 400\nLanding page conversion rate: 6%\nPaid search cost per demo: $45",  // -> K1..K3
  channels: ["landing", "blog", "email", "linkedin", "paid_search"],
  start: "2026-10-05", launch: "2026-10-20", end: "2026-11-20",
  budget: "18000",
  url: "https://quorvane.example.com/launch",
  voice: "Confident and practical, written for finance people: concrete numbers, no hype, short sentences."
});
if (A.errors.length) throw new Error(A.errors.join(" "));

const lane = process.argv[2] || "plan";           // "plan" or "draft"
const row = process.argv[3] || "C9";              // draft only: the calendar row to write
const plan = fs.existsSync("handoff.json") ? fs.readFileSync("handoff.json", "utf8") : null;  // optional
const body = K.buildInput(lane, A, { item: row, plan: plan, extra: "" });
if (!body) throw new Error(lane === "draft" ? "row " + row + " is not a draftable calendar row" : "the sheet has no calendar yet");
fs.writeFileSync("body.json", JSON.stringify(K.mustBeObject(body)));
console.log(lane, A.calendar.length, "calendar rows,", A.flags.length, "prescan flags");

# Always send an Idempotency-Key derived from the lane and the input. A retried
# request with the same key returns the SAME job instead of billing a second run.
KEY="campaign-desk:$LANE:$(printf '%s' "$INPUT" | shasum -a 256 | cut -c1-16):a1"

JOB=$(curl -sS -X POST "$BASE/run" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $KEY" \
  -d "$INPUT" | python3 -c 'import sys,json;print(json.load(sys.stdin)["data"]["job_id"])')

while :; do
  OUT=$(call "jobs/$JOB")
  STATUS=$(printf '%s' "$OUT" | python3 -c 'import sys,json;print(json.load(sys.stdin)["data"]["status"])')
  [ "$STATUS" = "succeeded" ] && break
  [ "$STATUS" = "failed" ] && echo "$OUT" && exit 1
  sleep 2
done

# {"ok":true,"data":{"job_id":"job_...","status":"succeeded",
#   "output":{"output":"{\"lane\":\"plan\",\"headline\":\"Quorvane's launch campaign targets ...\", ...}"},
#   "charged_credits":...,"truncated":false}}
printf '%s' "$OUT" | python3 -c 'import sys,json;print(json.load(sys.stdin)["data"]["output"]["output"])' > reply.json

# Server-sent events. `delta` events carry chunks of the reply; `done` carries the
# status, charged_credits and the truncated flag.
curl -N -X POST "$BASE/run-stream" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $KEY" \
  -H "Accept: text/event-stream" \
  -d "$INPUT"

# event: job    {"job_id":"job_..."}
# event: delta  {"text":"{\"lane\":\"plan\",\"headline\":\"Quorvane's launch campaign"}
# event: done   {"status":"succeeded","charged_credits":...,"truncated":false}

# reply.json holds data.output.output from step 5. Strip any fence, keep the object:
python3 - <<'EOF'
import json
t = open("reply.json").read()
r = json.loads(t[t.index("{"):t.rindex("}") + 1])
if r.get("lane") == "draft":
    print(r["ref"], r["channel"], r["asset"], "| cta:", r["cta"])
    for p in r["posts"] or [r["body"]]:
        print(len(p), "chars |", p[:80])
    for c in r["claims"]:
        print(c["ref"], "|", c["text"])
else:
    print(r["headline"])
    for c in r["calendar"]:
        print(c["ref"], "|", c["title"], "->", c["cta"])
    print("budget:", sum(l["amount"] for l in r["budget"]["lines"]))
EOF

# check.py - the structural invariants, given the body you sent and the parsed reply.
import json

def check(body, reply):
    brief, bad = json.loads(body["brief"]), []
    flags = [f["id"] for f in brief["prescan_flags"]]
    answered = [p["id"] for p in reply["prescan_responses"]]
    if sorted(answered) != sorted(flags):
        bad.append("prescan flags answered %s, sent %s" % (answered, flags))
    facts = {f["id"] for f in brief["facts"]}
    if reply["lane"] == "plan":
        rows = [c["id"] for c in brief["calendar"]]
        if [c["ref"] for c in reply["calendar"]] != rows:
            bad.append("calendar does not fill every row once, in order")
        if {c["channel"] for c in reply["channels"]} != {c["id"] for c in brief["channels"]}:
            bad.append("channel plan differs from the chosen channels")
        for k in brief["kpis"]:
            if not any(m["kpi_ref"] == k["id"] for m in reply["metrics"]):
                bad.append(k["id"] + " missing from metrics")
        spent = sum(l["amount"] or 0 for l in reply["budget"]["lines"])
        if spent > (brief["budget"] or 0) * 1.005:
            bad.append("budget lines add up to %s" % spent)
    else:
        item = json.loads(body["item"])
        if reply["ref"] != item["id"]:
            bad.append("draft is for " + reply["ref"])
        for lim in item["limits"]:
            v = reply[lim["field"]]
            for s in (v if isinstance(v, list) else [v]):
                if lim.get("max") and len(s) > lim["max"] and lim["hard"]:
                    bad.append("%s over %d: %d" % (lim["field"], lim["max"], len(s)))
            if isinstance(v, list) and lim.get("maxItems") and len(v) > lim["maxItems"]:
                bad.append("%s: %d items, at most %d" % (lim["field"], len(v), lim["maxItems"]))
        for c in reply["claims"]:
            if c["ref"] not in facts:
                bad.append("claim not tied to a proof point: " + c["text"])
    return bad

{
 "core": "Close the month without chasing a single invoice: Quorvane reads, codes and routes supplier invoices for approval on its own.",
 "pillars": [
  {
   "name": "Faster processing",
   "text": "In a 14-customer pilot, invoice processing time fell by 62% on average.",
   "proof_ref": "N1"
  },
  {
   "name": "Faster approvals",
   "text": "Pilot customers approved 91% of invoices within 48 hours, against 54% before.",
   "proof_ref": "N2"
  },
  "... 2 more"
 ],
 "audience": "Finance operations managers and controllers at 50-500 person companies who still key supplier invoices by hand and chase approvals over email at month end.",
 "row": {
  "ref": "C9",
  "title": "Close the month without chasing a single invoice",
  "angle": "Announces Quorvane to the full list and drives to the landing page.",
  "cta": "Request a demo."
 }
}

{"lane":"plan","headline":"...","summary":"...",
 "objectives":[{"text":"...","kpi_ref":"K1","target":"400","by":"2026-11-20"}],
 "audience":{"primary":"...","secondary":"","pains":["..."],"motivations":["..."],"where":["..."]},
 "messaging":{"core":"...","pillars":[{"name":"...","text":"...","proof_ref":"N1"}],"proof_gaps":["..."]},
 "channels":[{"channel":"email","role":"...","why":"...","cadence":"..."}],
 "calendar":[{"ref":"C1","title":"...","angle":"...","cta":"...","owner":"..."}],
 "metrics":[{"kpi_ref":"K1","name":"...","target":"400","type":"leading|lagging","source":"..."}],
 "budget":{"summary":"...","lines":[{"item":"...","amount":0,"why":"..."}]},
 "risks":[{"risk":"...","mitigation":"..."}],
 "prescan_responses":[{"id":"P1","status":"confirmed|dismissed","reason":"..."}]}

{"lane":"draft","ref":"C9","channel":"email","asset":"Launch email",
 "headline_options":["..."],"body":"...","posts":[],"headlines":[],"descriptions":[],
 "preheader":"...","meta_title":"","meta_description":"","hashtags":[],
 "cta":"...","claims":[{"text":"...","ref":"N1"}],"notes":["..."],
 "prescan_responses":[{"id":"P6","status":"confirmed|dismissed","reason":"..."}]}