<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Starts the social content flow for an app. Base44 reads the app, returns a one-sentence analysis of it, and asks 2 or 3 questions whose answers shape the content strategy.

Answer them with Submit answers. Calling this endpoint again restarts the flow. It discards any answers, strategy, and content plan already stored for the app. It fails with a 409 while a content plan is generating, so reset or finish that first.

This endpoint calls a language model, so expect it to take a few seconds. It shares a limit of 15 requests per minute with the other social content endpoints, except Get social content state and Generate a post image, which have their own.

<Note>The questions are generated per app, so both their number and their wording vary between calls. Read id and type off each question rather than assuming a fixed set.</Note>

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403. New social content generation and edits also return 403 with code app_marketing_not_allowed when the app's owning workspace has the FERPA designation. Historical reads and resetting the plan remain available.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

{
  "questions": [
    {
      "id": "goal",
      "question": "What does success look like for this app?",
      "type": "select",
      "options": [
        {
          "label": "Get the first 100 users",
          "description": "Focus on early adopters who give feedback"
        }
      ],
      "placeholder": "https://x.com/yourhandle"
    }
  ],
  "analysis_text": "A CRM for freelancers who want to track leads without a spreadsheet."
}