Sign in
Economic Intelligence

Create Recommendations

Generates a recommendation based on your input. Returns immediately; poll the list endpoint until its status is ready.

post/economic_intelligence

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Request body

account_idstring

Account ID, prefixed biz_. Defaults to the API key's own account.

inputstring required

What the owner wants, in their own words. Up to 1000 characters.

Example request

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "input": "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."
}

Response

recommendation queued

account_idstring nullable required

ID of the account this recommendation is for, prefixed biz_, or null for personal onboarding.

action_typestring nullable required

Type of action recommended, or null when no type is assigned. New values may be added; handle unknown types gracefully.

ai_chat_idstring nullable required

The chat to resume after its initial message is accepted, or null before a chat is ready.

created_atstring nullable required

When the recommendation was created, as an ISO 8601 timestamp, or null for an unsaved recommendation.

executed_atstring nullable required

When the recommendation was approved, as an ISO 8601 timestamp, or null if it has not been approved.

idstring required

Recommendation ID, prefixed reca_, or create_business for an unsaved setup recommendation. Authenticate and list again before executing an unsaved recommendation.

inputstring nullable required

What you requested, in your own words, or null for recommendations generated without your input.

promptstring nullable required

Step-by-step instructions for Whop AI, or null when no instructions are available.

reasoningstring nullable required

Evidence and metrics supporting the recommendation, or null when no reasoning was provided.

sentiment'positive' | 'negative' | 'null' nullable required

How the user rated this recommendation, or null if they have not rated it

status'queued' | 'pending' | 'ready' | 'executed' | 'superseded' required

queued when awaiting generation; pending while generating; ready when available for approval; executed when approved; superseded when rejected or replaced.

superseded_atstring nullable required

When the recommendation was rejected or replaced, as an ISO 8601 timestamp, or null if neither has occurred.

target_urlstring nullable

Website URL selected for pixel setup, or null when no website was captured for this recommendation.

titlestring nullable required

Recommended action and its expected benefit, or null until generated.

user_feedbackstring nullable required

The user's written feedback, or null if they have not provided any.

Example response

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "action_type": "improve_landing_page",
  "created_at": "2026-01-01T12:00:00.000Z",
  "executed_at": "2026-01-01T12:00:00.000Z",
  "id": "reca_xxxxxxxxxxxxxx",
  "input": "more buyers",
  "prompt": "Create a 20% off promo code for my members.",
  "reasoning": "Capped 9 of 14 days.",
  "sentiment": "positive",
  "status": "executed",
  "superseded_at": "2026-01-01T12:00:00.000Z",
  "target_url": "https://example.com/join",
  "title": "Move $180 from 3 dead ad groups into BATCH#3, +1.7x return"
}

Changes