Create a third-party LEAD-GENERATION page about a business (NOT a site for that business itself).
Use this when the goal is to drive qualified search traffic to someone else's business — affiliate pages, review/guide pages, niche directories. The page is branded as an outside guide (e.g. "Best Roofers in San Diego"), refers to the business in the third person, and routes CTAs to the business's existing website.
Differences from create_site:
- Slug + page brand are SEO-vanity (e.g. "best-roofers-sandiego"), not the candidate's brand name.
- Voice is third-party guide/reviewer — never first person.
- Primary CTA is "visit their website"; phone/email demoted.
- No specific pricing quoted; differentiators emphasized.
- Locality is judged by category, not just address (IT/SaaS/agency stays category-wide even when a city is on file).
Pass a business candidate object from search_businesses — that business is the one being PROMOTED.
Requires authentication via API key (Bearer token).
Generate an API key at webzum.com/dashboard/account-settings.
The page generation happens in the background. Use get_site_status to check progress.
Returns the businessId (a vanity slug) which can be used to access the page at /build/{businessId}.
Connector