The whole direct-mail lane has been stuck on one thing: no price and no working API route for handwritten mail. Both are now solved on paper. The API is real, live and fully documented — and there's a way to get exact per-piece prices without filling in their form and waiting for a sales reply. Below: the three things to do tonight, the call script for Stuart, and Oliver's parallel lane.
Both guides Stuart sent tell you to log in at portal.roboquill.io — and that hostname does not exist (NXDOMAIN). Same for the api.roboquill.io he gave you on WhatsApp. The guides have the wrong TLD throughout: it's .com, not .io. On the right domain everything is up:
https://api.roboquill.com — 401 on /Account and /Template, i.e. alive and correctly demanding a key/openapi.jsonEarlier note on this page said there was no self-serve signup. That was true of roboquill.io — every likely path there 404s — but wrong about the actual portal, which is on .com. Corrected.
enquiries@theaiconsultant.co.uk. It's a live form — try it before emailing anyone.X-Auth-Key.doppler secrets set ROBOQUILL_API_KEY --project infra --config prd. It's a spend-capable credential — anyone with it can place live orders on our account.There is no public price or quote endpoint. Verified against their live OpenAPI spec today — the entire API is ten endpoints, all authenticated:
GET /Account · GET /Template · GET /Template/{code} · POST /Order · GET /Order · GET /Order/{id} · DELETE /Order · DELETE /Order/{id} · POST /Order/preview · GET /Activity
But POST /Order with "isTest": true runs the full validation and costing pipeline, and their own guide states test orders are "not printed or posted and do not consume credits". The response comes back with the money broken out:
{ "cost": "1.50", "vat": "0.30", "total": "1.80",
"postage_cost": "0.85", "status": "Queued", "isTest": false }So once you have a key, you can price every template against every country, for free, in about ten seconds — which is exactly the clear published price table their website declines to give you. Script is written and ready:
doppler run --project infra --config prd -- \
python3 ~/ClaudeProjects/Klaudius/postcards/roboquill/price-probe.py GB DEIt lists your enabled templates, fires one test order per template × country, and prints a cost / VAT / postage / total matrix — then writes price-matrix.json beside itself.
total or on top?Their example shows cost 1.50 + vat 0.30 = total 1.80, with postage_cost 0.85 sitting outside that sum. If postage is additive, the real landed figure is ~£2.65, not £1.80 — a 47% difference, and it decides whether pen is viable at all.
The website's own framing supports additive: "prices exclude VAT; postage charged at cost." Don't model either way until it's confirmed — check GET /Activity after the first real order, and ask Stuart directly.
| Product | Published | Notes |
|---|---|---|
| Handwritten note (A6/A5) | from £1.53 | 40–60 words works best. Full-colour logo on card, QR supported ("a review page, an offer or a loyalty link"), merge fields, 350gsm silk or uncoated, matching coloured envelope. Min 10 manual, none via API. |
| Handwritten letter (A4) | from £2.05 (~£2.96 with 2nd class) | The number in the sample pack. Not our unit. |
| Stannp printed A6 postcard | £0.96 all-in | Write-path already driven end-to-end. |
| Intelliprint printed A6 | £0.89 flat 1→5,000 | API proven with testmode:true. Leeds, same-day before 3pm. |
The real question this frames: pen costs roughly 2–3× printed. Handwriting only has to beat printed on response rate by that multiple to win — and on a first cold touch to a local business, it plausibly does. That's the bet, and the price probe turns it from a guess into arithmetic.
Important nuance: the note ships in an envelope, not as an open postcard. That's not a downside — a pen-addressed envelope is the single strongest A-pile signal there is. But it changes the QR mechanic: the recipient must open it before they can scan, so the envelope has to survive the bin on handwriting alone.
Mobile, from his own letter to you — he wrote "we'll contact you in a few days to discuss further", so this is an expected call, not a cold one:
Office: +44 1780 908124 · hello@roboquill.io · Sycamore Place, 1 South Road, Bourne, Lincolnshire, PE10 9JB
"Hi Stuart — Paul Cowen. You sent me a sample pack a few weeks back, the pen-written letter — thanks, it's genuinely convincing, that's why I'm ringing. Five minutes?
Quick context: I build websites for local businesses and I reach them by post rather than email — they get a card, scan a QR, and it opens a site I've already built for them. So it isn't a one-off campaign; it's continuous, and it scales as it works. I've read your API guide and I'm registering on the portal now. Four things and I can start building against it — can I fire them at you?"
Names the sample (warm), states the model in one breath, signals recurring volume — which is what earns a real price rather than a list price — and tells him you've already done the reading, which changes the register of the whole call from prospect to integrator.
postage_cost inside total or on top?"
POST /Order takes a template code plus a fields object, so what we can actually say is bounded by what he sets up. The notes page says QR is supported; confirm it can be per-recipient (each business gets its own tracked URL), not one static QR for everyone. Per-recipient QR is the entire measurement model — without it, QR stats die.countryCode, so it's technically open — but the price and transit time to DE are unknown, and Oliver's entire half of the pipeline is DACH. Ask for it by email so it exists outside one phone.Then, if the call is going well: envelope-only — pen-addressed envelope around our own printed insert. That's the cheap hybrid, his handwriting on the outside (which is what beats the bin) with our economics on the inside. It's listed as a product, so it has a price.
"One thing that'll save you support tickets — both PDFs point at portal.roboquill.io and api.roboquill.io, and neither of those resolves. The working ones are .com. I only found the portal by guessing the TLD."
Costs nothing, is genuinely useful to him, and buys goodwill right before you ask for volume pricing. It also quietly demonstrates you've actually driven the API rather than skimmed the brochure.
"Hi Stuart — Paul Cowen. You sent me a sample pack (pen letter + QR card) and the API guides. I'm signing up on the portal now and want to talk volume: recurring UK + Germany, driven through your API. Four quick questions and I can get moving. When suits for 10 minutes tomorrow? — Paul"
Short, states the money and the volume, gives him a reason to ring back in the morning. Don't put the four questions in the text — a written list gets answered with a brochure.
print.one onboarding hard-requires an EU-validated VAT number. Paul is structurally locked out — a GB number isn't in EU VIES post-Brexit, and there's no non-VAT path. Oliver's DACH company can sign up; Paul cannot.
Once in: pull an API key, and read the UK and DE landed prices off the dropdown by hand — the pricing calculator is client-side React and didn't recompute for Europe/World under scripted input, so only the ~€0.69/A6 NL default is confirmed. UK and DE are unknown until a human clicks it.
Same artwork, same list, both sent — Stannp (UK, £0.96 A6 all-in, write-path already driven) vs print.one (NL). Compare landed cost, days to letterbox, print quality.
Carry this correction in: Oliver has no print.one adapter — verified by reading ozdreamwalk/ozdreamsites directly. Zero references to print.one anywhere, and no postal send implementation at all; outreach.ts is email-only. This is unbuilt work, not a reuse. Scope it that way.
Post one real RoboQuill note to his own address and time it door-to-door.
"No problem" from a vendor and a note actually landing in Bavaria in four days are different facts. DACH is his half, so it should be his letterbox — and he can judge whether the handwriting reads as convincing in German, which none of us can.
Which lane does OzDreamSites run first — pen or printed? Same decision as Paul's, different geography and postage economics.
Worth an IDS slot at the next Weekly Pulse rather than a side conversation, because it decides which adapter gets built first.
| Where you land | Read | Next move |
|---|---|---|
| Key in hand, price probe returns under ~£1.80 landed at volume, per-recipient QR confirmed | Pen lane is live | Build the RoboQuill adapter this week. Pen note on the Day-0 touch, printed on Day-15/25. |
| Works, but lands nearer £2.65 with postage on top | Premium touch only | Pen for the Day-0 touch on high-value prospects; printed at 89p for everything else. Test the split before committing volume. |
| Registration needs manual approval and no reply, or QR can't be per-recipient | Not a lane yet | Ship Intelliprint at 89p now. Revisit when he replies — the API is genuinely good, so it's worth keeping warm. |
Either way the lane moves this week — printed is tested, cheap and ready. The only thing pen can cost us now is the premium, and the price probe settles that for free.
~/ClaudeProjects/Klaudius/postcards/roboquill/RoboQuill-API-Guide.pdf~/ClaudeProjects/Klaudius/postcards/roboquill/RoboQuill-Make-Zapier-Guide.pdf~/ClaudeProjects/Klaudius/postcards/roboquill/price-probe.py~/ClaudeProjects/Klaudius/postcards/vendor-comparison.md