---
title: "Create site"
method: POST
path: "/api/sites/multiscreen/create"
tags: ["Sites"]
---

# Create site

`POST /api/sites/multiscreen/create`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/sites/multiscreen/create`
- Auth: HTTP basic

Creates a new site from a template and returns its `site_name`. Store the `site_name`: it's unique across all Duda sites, and you need it for every other call about the site.

## Request body

- DudaOneCreateRDT
  - `default_domain_prefix` string
  - `do_not_gen_ssl` boolean
  - `labels` SiteLabelRDT[]
    - `name` string
  - `lang` string: Rejected when building from a vibe template.
  - `site_data` DudaOneSiteRDT
    - `account_name` string
    - `editor` 'SIMPLE' | 'ADVANCED' | 'ADVANCED-2.0' | 'VIBE'
    - `external_uid` string
    - `google_tracking_id` string
    - `googletagmanager_container_id` string[]
    - `piwik_id` string: Rejected when building from a vibe template.
    - `removeBizInfos` boolean: Rejected when building from a vibe template.
    - `schemas` SiteSchemasRDT
      - `local_business` LocalBusinessSchemaRDT
        - `enabled` boolean
        - `missing_recommended_fields` string[]
        - `missing_required_fields` string[]
        - `status` string
    - `site_alternate_domains` SiteAlternateDomainsRDT
      - `domains` string[]
      - `is_redirect` boolean
    - `site_business_info` SiteBusinessInfo: A Site Business Info data structure is used by multiple Site APIs and is represented by the properties below. Providing this information during site creation improves the conversion of the mobile site and helps populate site data.
      - `address` Address: An Address data structure is used by multiple Site APIs and is represented by the following properties. Providing an address helps the site creation process by giving Duda more information about the location of the site. For example, if you provide an address we will automatically populate a mobile maps button and potentially find other resources online.
        - `city` string
        - `country` string
        - `state` string
        - `street` string
        - `zip_code` string
      - `agendize_info` AgendizeSiteInfo: An Agendize Info data structure is used by multiple Site APIs and is represented by the properties below. Providing this will create an Agendize widget and help Duda find more information about the website online.
        - `account_id` string
        - `company_id` string
      - `business_name` string
      - `email` string
      - `opentable_info` OpenTableInfo[]
        - `country` string
        - `location` string
        - `restaurant_id` string
      - `phone_number` string
    - `site_domain` string
    - `site_seo` SiteSEORDT
      - `description` string
      - `no_index` boolean
      - `og_image` string
      - `title` string
  - `template_alias` string: Alias of the template to build from. A vibe template creates a vibe site, which rejects url, lang, xframe_options and any of site_data.{piwik_id, site_seo, removeBizInfos, schemas, editor, site_business_info}.
  - `template_id` integer: Deprecated, use 'template_alias'.
  - `url` string: Rejected when building from a vibe template.
  - `xframe_options` ApiXFrameOptions
    - `allowed_domains` string[]: Allowlisted parent origins when return_xframe_headers is true (typically insertion-ordered set).
    - `return_xframe_headers` boolean: When true, the site sends X-Frame-Options / frame-ancestors style restrictions.

## Response `200`

OK

- SiteIDRDT
  - `site_name` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `405`: Method Not Allowed
- `429`: Too many requests. The rate limit was exceeded.
- `500`: Internal Server Error

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)