# Stackify Calendar — agent guide

Turn a human's followed Instagram accounts into a maintained calendar. You (the agent)
create a "stack" of handles; we scrape daily, LLM-extract real time-sensitive events
(shows, openings, screenings, games — plus brand moments like archive sales, limited drops,
restocks and sample sales), each with title, ISO start, venue, source post and flyer
thumbnail, and email your human. They first get a WELCOME EMAIL with their dashboard
magic-link, then a morning digest of new events — ONE EMAIL PER INSTAGRAM ACCOUNT by default
(a dashboard toggle combines them into one). EVERY email (welcome and each digest) carries
their private dashboard magic-link, so they can always open it to add or remove accounts.
Each event has a one-tap add-to-calendar link (Google/Apple); nothing is added unless the
human taps it. An optional auto-subscribe .ics feed comes too. Billed per use through
ZeroClick — no accounts, no API keys on your side.

(Want their raw posts in the inbox instead of extracted events? That's Stackify Social —
one email per creator per day, verbatim: /social/llms.txt)

Base URL: https://stackify.pay.zeroclick.io  (ZeroClick pay rail — handles x402/MPP payment
and request signing; pay-per-use, no signup. The upstream rejects unsigned calls.)

Pay-per-use, drawn from your human's prepaid Zero balance — each call spends a few cents of
USDC. No subscription, no separate top-up step: the wallet balance IS the prepaid credit.
No Zero wallet yet? Install it — `npm i -g @zeroxyz/cli`, then `zero auth login` (your human
authorizes in the browser). First-time signups get a FREE $5 welcome credit (no card), which
covers the first ~3 weeks of a small stack.

SETUP: first ask your human WHICH Instagram accounts to watch and their EMAIL — don't guess
these. Then create their stack (below).

QUICKSTART (Zero wallet / any x402 client — no signup, wallet is identity):
  zero fetch https://stackify.pay.zeroclick.io/v1/stacks -X POST \
    -H 'content-type: application/json' \
    -d '{"handles":["ig1","ig2"],"email":"human@x.com"}' --max-pay 0.30 --json
  First call → 402 payment challenge → your wallet pays USDC → ZeroClick signs + proxies →
  you get { stackId, dashboardUrl, feedUrl }. Hand the human dashboardUrl (we also email it to
  them in a welcome email). They then get a morning digest — one email per account by default —
  and tap Add-to-calendar per event. feedUrl is optional auto-subscribe. Done.

POST /v1/stacks
  body: { "handles": ["ig_handle", ...(≤25)], "email": "optional@human.com" }
  → 201 { "stackId": "stk_…", "dashboardUrl": "…/#k=…", "feedUrl": "…/feed/….ics" }
  meters: stack_created ×1. dashboardUrl is a MAGIC LINK — give it to your human; we also include
  it in every email we send them (the welcome email and each morning digest). Opening it logs them into the dashboard (no password/Google/wallet), enrolls
  that device, and is where the daily emails link back to. In the dashboard the human can add/remove
  handles (with live Peek), copy their ICS feed, toggle combine-emails, and see usage. feedUrl is
  optional auto-subscribe for calendar apps. Treat both URLs as secrets.

GET /v1/stacks/:id            → status, handles, current events (free)
POST /v1/stacks/:id/handles   → { "add": "handle" } or { "remove": "handle" } (free)
POST /v1/stacks/:id/peek      → { "handle": "x" } → followers/verified/9 thumbnails
                                 (meters: peeks ×1; ~15s — a sandbox scrapes live)

Pricing (meters, USDC, no base fee, drawn per use from the Zero balance): stack_created $0.25
(once, on create) · handle_days $0.05 (per watched handle, per daily refresh) · peeks $0.05
(per preview) · emails $0.02 (per digest email sent — one per account per day by default).
Recurring: handle_days ×N per daily refresh (N = watched handles) reported idempotently per
stack per day, plus emails for that day's digests. A 3-handle stack ≈ $4.50/month — the free
$5 welcome credit covers getting started. Delete-to-stop.

Event shape:
{ "title": str, "startsAt": ISO8601-with-offset, "venue": str|null,
  "sourceUrl": instagram-post-url, "image": flyer-thumbnail-url, "handle": str }

Good citizenship: don't create stacks for emails/humans who didn't ask; the dashboard
has one-click handle removal and the human can always stop via their link.