Campaigns for agents 🤖
Creator campaigns can now be created and edited through the API — from your own tools, an n8n workflow, or an agent — using the same vocabulary the campaign sheet uses.
You send a campaign spec: the cadence, the payout window, the video target, and the payouts (a fixed salary, a base payout per video, CPM tiers, flat bonuses, a performance cap, the eligibility window). viral.app turns it into payout rules on the server, exactly as the sheet does, so nothing can be set up through the API that your team could not have built by hand.
Three things make it safe to hand to an agent:
- Every campaign comes back described in plain sentences, one per rule-set, in the sheet's own wording — "Creators get paid €10.00 per video. This equals €300.00 in total every month, if they reach the video target of 30."
POST /api/v1/campaigns/validatedry-runs a spec before any write: the normalized spec, the sentences, the sheet's alerts, and a preview hash. Pass the hash to the write and a spec that drifted from the reviewed one is refused.- An edit re-derives the payout rules from the merged spec whenever the payouts, the video target or the currency change, so changing the video target alone moves the base payout's cap with it. Fields locked by assignments stay locked; rules the spec cannot express survive edits untouched.
Ending and reactivating a campaign, and assigning creators, are open to API keys too — each with a preflight that returns the cycle-aligned dates and what the change would affect. Read Campaigns via the API.
The Copilot sets up campaigns with you
Create Campaign now offers Build it with Copilot. The Copilot asks where you are starting from — from scratch, from one of your job listings, or by copying a campaign — then only for what is missing: how often creators get paid, whether payout windows are rolling or fixed, the target, the amounts. Pasted deal terms work as a start too.
Before anything exists it shows the payout rules as sentences in a card; approving that card is the review. Afterwards it offers the next step, one at a time — assign creators, attach or write a brief.
"Tune a campaign's payouts" does the same for a live campaign: it reads the rules, applies your change, and shows before and after. Campaign writes are approved one call at a time — there is no "Always allow" for them, so a scheduled run can never create or change a campaign on its own.
