Storefront onboarding

From a new seller account to a storefront that can transact: the readiness checklist, step by step.

A storefront is ready to transact when every blocking check on Get ready to sell is complete. Open it with “What do I need to start selling?” or open_page (page: "seller_setup"). The rail header shows your status (for example “Live — attention”) and how many steps are done, for example “7 of 10 steps”.

The checklist

Check	Done when	Where
Company identity	Company name, domains and brand are confirmed.	Listing
Listing	A description, channels and accepted countries are set.	Listing (save_seller)
Inventory source	At least one source is connected and healthy.	Inventory sources
Products	At least one product has a name, channel, format and a priced option.	Products
Currency	The storefront’s default currency is confirmed.	Listing
Acceptance policy	An AI Business Rules version is active.	AI Business Rules
Approval settings	Both gates have been reviewed.	AI Business Rules
First intelligence run	The storefront agent has answered a practice brief.	Demand inbox
Billing	A plan is selected.	Settings → Plan & billing
Publish validation	A sandbox transaction completed end to end.	Automatic

Each check shows its status (complete, partial, missing or optional), whether it blocks transacting, and the action to take.

Listing only, or a hosted agent?

Choose how you want to sell under Settings → How would you like to sell?:

• Just list: buyers find you on Semicola and briefs pass straight to your own AdCP sales agent, after a policy screen. Free.
• Create an agentic media company account: Semicola hosts a storefront agent that composes proposals from your products, playbook and library, billed per brief response in IUs.

Liveness

Once live, the storefront reports live, live_attention (something needs a look, such as a slow source) or live_critical (buyers cannot transact). You can put intake on hold at any time; buyers then see the storefront as unavailable.

Confirm your company identity

A new Seller account starts by confirming who it is: company name, website, how it wants to sell (LISTING_ONLY or AGENTIC_MEDIA_COMPANY) and its contracting country. An admin submits it with POST /api/v2/onboarding/media-company-identity; GET on the same path reads the current state.

The intake moves AWAITING_IDENTITY_CONFIRMATION → RESEARCHING, then to APPROVED, or to EXCEPTION_REVIEW for a person at Semicola to look at. An unsupported country is refused (“Country not yet supported.”).

Readiness over REST

All under /api/v2/storefront:

Endpoint	What it does
GET /readiness	Every readiness check with its status, whether it blocks go-live, and the next action; plus liveness.
POST /readiness/compliance/refresh	Run the checks again.
POST /resolve-brand	Resolve a domain’s brand card (name, logo, colors) without saving it.

The domain checks are explained in Which domain is which.

Not available yet

• A research-backed setup draft for approved applicants.
• Discover agents: finding the operator and publisher agents a domain’s adagents.json authorizes.
• The identity decision is automatic today: RESEARCHING lasts only while the admission check runs (usually well under a second). Your own sign-up domain, or a domain the brand registry knows, is approved; others go to exception review. There’s no human research step behind RESEARCHING.