Serge developer hub
Start with your business, campaign plan and reviewed ad copy. You can prepare them while OpenAI reviews your advertiser account. When creation is available, Serge builds the campaign, ad group and ads paused in your own account. Running is a separate step with its own availability checks and your explicit budget approval.
How Serge works with your account
You own the OpenAI ads account and its billing. Serge connects through an Ads API key you create and can revoke, and stores it encrypted. Campaigns are built paused when creation is available. Available run and pause controls are in your campaign workspace; running needs OpenAI approval and your explicit budget approval. Serge does not target exact conversations or increase your budget automatically.
Walkthrough: the OpenAI account, review and Ads API key handoff
First-party measurement
Measurement is optional and does not block campaign creation. The Serge snippet can record supported campaign parameters or click references that reach your site and associate subsequent site activity with them. This first-party measurement is separate from the available OpenAI campaign totals shown in the campaign workspace. Neither source guarantees that every click or outcome is observed.
Install happens in the app under Site: copy the one-line script tag and your public token. Consent mode and a first-party proxy are available for sites that need them.
MCP server
The Serge MCP server connects your LLM client — Claude, Cursor — to your Serge workspace, so you can ask about your measured traffic and sessions in plain language. Authentication is via OAuth (your Serge login) or a workspace API key.
Machine-readable resources
For LLMs and crawlers that want the product described in their own format: llms.txt is the concise product description, llms-full.txt the extended version. Both are kept current with the product.
Current boundaries
New campaigns are ChatGPT-only. Google and Microsoft campaign creation is not available. Paused creation and live running have separate availability checks; account and ad reviews still apply. When connected and available, Serge reads verified campaign status and OpenAI campaign totals and offers explicit run and pause controls. Missing results stay unavailable, and reporting can lag. You can also check your account at ads.openai.com.
Questions the docs don’t answer? Contact us — we respond to every message.