---
title: "Create a landing page on the account's subdomain (claim the subdomain in the app first)"
method: POST
path: "/api/pages"
---

# Create a landing page on the account's subdomain (claim the subdomain in the app first)

`POST /api/pages`

## Request

- Base URL: `https://app.whooshly.co`
- URL: `https://app.whooshly.co/api/pages`
- Auth: HTTP bearer

## Request body

- object
  - `fields` object, required: title + blocks (hero/text/image/button/divider/form)
  - `slug` string
  - `theme` object

## Response `201`

Created

## Other responses

- `402`: Error — `error` is a stable code. Common: core_locked (account hasn't purchased — buy at the app), pro_required (feature needs Pro), slug_taken, limit_reached, not_found, rate_limited, invalid (see issues).
- `409`: Error — `error` is a stable code. Common: core_locked (account hasn't purchased — buy at the app), pro_required (feature needs Pro), slug_taken, limit_reached, not_found, rate_limited, invalid (see issues).
- `422`: Error — `error` is a stable code. Common: core_locked (account hasn't purchased — buy at the app), pro_required (feature needs Pro), slug_taken, limit_reached, not_found, rate_limited, invalid (see issues).

---

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