---
title: "Create a site"
method: POST
path: "/api/provision"
tags: ["Site Creation"]
---

# Create a site

`POST /api/provision`

## Request

- Base URL: `https://www.1clickwebsite.ai`
- URL: `https://www.1clickwebsite.ai/api/provision`
- Auth: HTTP bearer

Queues a complete V2 WordPress website build. One accepted build uses one site credit. Call `GET /api/templates` first and submit an available `templateId` and optional `themeId`.

## Request body

- SiteCreateRequest
  - `templateId` string, required: Template ID returned by `GET /api/templates`.
  - `themeId` string: Optional theme ID returned by `GET /api/templates`.
  - `builderVersion` 'v2'
  - `businessName` string, required
  - `primaryLanguage` 'en' | 'es' | 'fr' | 'de' | 'it' | 'ro' | 'tr'
  - `industry` string
  - `email` string, email
  - `phone` string
  - `address` string: Legacy combined public address. Supported for compatibility; structured fields are preferred.
  - `addressLine1` string: Public street address. Omit when `hasPublicBusinessAddress` is false.
  - `addressLine2` string: Optional suite, unit, building, or floor.
  - `addressCity` string: City or locality. May be supplied without a street address for service-area or online businesses.
  - `addressRegion` string: State, province, or region.
  - `addressPostalCode` string: Postal code. Omit when `hasPublicBusinessAddress` is false.
  - `countryCode` string: Two-letter ISO country code.
  - `hasPublicBusinessAddress` boolean: When false, the street address and postal code are discarded and do not appear on the generated site. City, region, and country may still anchor service-area content.
  - `googlePlaceId` string
  - `businessWebsite` string, uri
  - `aboutBusiness` string
  - `businessHoursMode` 'weekly' | 'open_24_hours' | 'do_not_display': Display behavior for the main business hours. If omitted, a supplied businessHours value implies weekly; otherwise hours are hidden.
  - `businessHours` string: Weekly schedule as a JSON-encoded string or supported plain text. Used only with businessHoursMode=weekly.
  - `customerModel` 'visit_business' | 'travel_to_customers' | 'hybrid' | 'remote_online': How customers interact with the business. visit_business and hybrid require hasPublicBusinessAddress=true.
  - `services` string[]
  - `serviceAreas` string[]
  - `locations` object[]
    - `name` string, required
    - `address` string
    - `phone` string
    - `email` string, email
    - `hours` string: Weekly schedule as a JSON-encoded string or supported plain text.
    - `hoursMode` 'weekly' | 'open_24_hours' | 'do_not_display': Display behavior for this location's hours.
    - `mapUrl` string, uri
    - `description` string
    - `content` string
  - `logoUrl` string, uri
  - `skipImages` boolean
  - `createServicePages` boolean
  - `createServiceAreaPages` boolean
  - `createLocationPages` boolean
  - `primaryColor` string
  - `secondaryColor` string
  - `backgroundTheme` 'light' | 'dark'
  - `headingFont` string
  - `bodyFont` string

## Response `202`

Build accepted and queued

- SiteCreateAccepted
  - `slug` string, required
  - `siteId` string, uuid, required
  - `previewUrl` string, uri, nullable
  - `statusUrl` string, required

## Other responses

- `400`: Invalid or missing request data
- `401`: Missing, invalid, or revoked API key
- `403`: Insufficient access, credits, or template availability
- `503`: Site generation is temporarily in maintenance mode

---

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