> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# Marketing Agent

> Set up the Marketing Agent for an app and talk to it with the Base44 Apps API

<Note>
  The Apps API is in beta. Its endpoints and responses may change.
</Note>

These endpoints set up the Marketing Agent for an app and let you talk to it. The agent reads the app and drafts marketing channels, KPIs, and a strategy for you to review. See [Using the Marketing Agent for your app](/promoting-your-app/creating-a-marketing-plan) for the same feature in the Base44 online app editor.

The first run in a workspace creates the workspace's Marketing Agent, a Superagent that everyone in the workspace shares. Each run is a Superagent turn, charged to the workspace in message credits.

## Setup steps

Setup moves through steps, and the agent waits at each one for your approval.

**To set up the Marketing Agent:**

1. Call [Start Marketing Agent setup](/api-reference/start-marketing-agent-setup). The work runs in the background.
2. Poll [Get Marketing Agent state](/api-reference/get-marketing-agent-state) until `status` is `ready` or `error`. Setup then waits at a `setup_stage` of `channels`.
3. Approve each step with [Answer Marketing Agent setup step](/api-reference/answer-marketing-agent-setup-step), or ask for changes with [Send Marketing Agent message](/api-reference/send-marketing-agent-message). The steps are `channels`, `kpis`, and `budget`.
4. After the budget step, the agent writes the strategy. Poll the state again until `status` is `ready`.

After setup, [Send Marketing Agent message](/api-reference/send-marketing-agent-message) is an ordinary conversation about the app's marketing.

## Endpoints

* [Start Marketing Agent setup](/api-reference/start-marketing-agent-setup): Start setup, which drafts channels and KPIs.
* [Answer Marketing Agent setup step](/api-reference/answer-marketing-agent-setup-step): Approve the step the agent is waiting on.
* [Get Marketing Agent state](/api-reference/get-marketing-agent-state): Read the agent's plan and the state of its latest run.
* [Send Marketing Agent message](/api-reference/send-marketing-agent-message): Send a message and start the turn that answers it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.