---
title: "Generate a landing page"
method: POST
path: "/landing-pages"
---

# Generate a landing page

`POST /landing-pages`

## Request

- Base URL: `https://namemy.app/api/v1`
- URL: `https://namemy.app/api/v1/landing-pages`
- Auth: HTTP bearer

Gated: Founder/Agency sub OR SITE_BUILDER purchase. Returns an id to pass to `/landing-pages/{id}/deploy`.

## Request body

- LandingPageInput
  - `businessName` string, required
  - `industry` string, required
  - `description` string, required
  - `targetAudience` string
  - `uniqueValue` string
  - `theme` 'default' | 'dark' | 'minimal'
  - `ctaText` string
  - `ctaUrl` string
  - `includePricing` boolean
  - `includeTestimonials` boolean
  - `includeFAQ` boolean

## Response `200`

Landing page generated

- LandingPageOutput
  - `id` string
  - `status` 'ready' | 'deployed' | 'failed'
  - `name` string
  - `industry` string
  - `files` object[]
    - `path` string, required: Relative file path inside the generated site bundle
    - `content` string, required: File contents (UTF-8 text for HTML/CSS/JS)
  - `config` object: Declarative landing-page config consumed by the deployer
    - `theme` 'default' | 'dark' | 'minimal'
    - `hero` object
      - `headline` string
      - `subheadline` string
      - `primaryCta` string
      - `primaryCtaUrl` string
    - `sections` object[]
      - `type` 'hero' | 'features' | 'pricing' | 'testimonials' | 'faq' | 'cta' | 'footer'
      - `heading` string
      - `body` string
    - `seo` object
      - `title` string
      - `description` string
      - `canonical` string
  - `preview` string: Preview URL for the generated page (pre-deploy)
  - `deployUrl` string: Endpoint to POST to in order to deploy: /api/v1/landing-pages/{id}/deploy

## Other responses

- `402`: Payment required — endpoint gated by subscription or one-time add-on
- `429`: Rate limit or daily quota exceeded

---

[API](https://skmtc.dev/namemy/apis/namemy-app-api.md) · [All operations](https://skmtc.dev/namemy/apis/namemy-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/namemy/apis/namemy-app-api/revisions/1c302ede4b63?raw)