Create Recommendations
Harnesses Economic Intelligence to generate recommended actions that lead the business down the most optimal path to the next dollar. Returns a queued recommendation right away. Poll the list endpoint until it is ready or failed.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-09-11-1"
Body
What the owner wants, in their own words. Up to 1000 characters.
1000"I sell $79 customized gym straps. The number of purchases per day fell from 84 to 66 since June and my ads cost per signup doubled to $38. Half the leads never open the checkout. I want to win back churned visitors and lift conversion without cutting the price, and I can spend up to $500 this month on it."
Account ID, prefixed biz_. Defaults to the API key's own account.
"biz_xxxxxxxxxxxxxx"
Response
recommendation queued
The account this recommendation is for, prefixed biz_
"biz_xxxxxxxxxxxxxx"
The playbook action this card recommends, or null for an untyped card; new values may be added, so handle unknown types gracefully
"improve_landing_page"
When the recommendation was created, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
When the card was run, as an ISO 8601 timestamp, or null
"2026-01-01T12:00:00.000Z"
Economic intelligence ID, prefixed reca_
"reca_xxxxxxxxxxxxxx"
What the owner asked for, in their own words, when this recommendation was requested, or null when the engine chose the action on its own
"Grow revenue"
The step-by-step brief Whop AI executes when the card is run, or null
"Create a 20% off promo code for my members."
The signal and number the recommendation rests on, or null
"Revenue fell by 20%."
queued once requested and not yet picked up; pending while the engine is generating; ready when the card is written and the owner can run it; executed once it was run; superseded when a newer card of the same action type replaced it; failed when the engine had nothing to recommend for the request
queued, pending, ready, executed, superseded, failed "superseded"
When a newer card replaced this one, as an ISO 8601 timestamp, or null
"2026-01-01T12:00:00.000Z"
The recommendation as the owner sees it: one command with the payoff, or null until the engine has written the card
"Move $180 from 3 dead ad groups into BATCH#3, +1.7x return"

