For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Resources
Get started
ReferenceGuidesExamplesChangelog
ReferenceGuidesExamplesChangelog
  • Data API
    • Introduction
  • Token
    • GETGet Authorization User Info
    • GETGet Authorization Info
  • Sites
    • GETList Sites
    • GETGet Site
    • GETGet Custom Domains
    • POSTPublish Site
  • Pages and Components
  • CMS
  • Forms
  • Custom Code
  • Assets
  • Custom fonts
  • Comments
    • GETList Comment Threads
    • GETGet Comment Thread
    • GETList Comment Replies
  • Ecommerce
  • Webhooks
    • GETList Webhooks
    • GETGet Webhook
    • POSTCreate Webhook
    • DELRemove Webhook
  • Site Configuration
  • Enterprise
      • POSTCreate Site
      • PATCHUpdate Site
      • DELDelete Site
      • GETGet Site Plan
LogoLogo
Resources
Get started
EnterpriseWorkspace Management

Create Site

POST
https://api.webflow.com/v2/workspaces/:workspace_id/sites
POST
/v2/workspaces/:workspace_id/sites
$curl -X POST https://api.webflow.com/v2/workspaces/580e63e98c9a982ac9b8b741/sites \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "name": "The Hitchhiker'\''s Guide to the Galaxy"
>}'
1{
2  "id": "670ecf86817e3cc7a510eb6a",
3  "workspaceId": "625860a7a6c16d624927122f",
4  "createdOn": "2024-10-15T20:24:38.134Z",
5  "displayName": "The Hitchiker's Guide",
6  "shortName": "hitchikers-guide",
7  "lastPublished": "2024-11-15T20:24:38.326Z",
8  "lastUpdated": "2024-10-15T20:24:38.326Z",
9  "previewUrl": "https://preview.mysite.com",
10  "timeZone": "America/Los_Angeles",
11  "dataCollectionEnabled": true,
12  "dataCollectionType": "always",
13  "parentFolderId": "670ece123598db72d9648be1",
14  "customDomains": []
15}
Create a site. <Warning title="Enterprise Only">This endpoint requires an Enterprise workspace.</Warning> Required scope | `workspace:write`
Was this page helpful?
Previous

Update Site

Next
Built with

Create a site.

Enterprise Only
This endpoint requires an Enterprise workspace.

Required scope | workspace:write

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

workspace_idstringRequiredformat: "objectid"
Unique identifier for a Workspace

Request

This endpoint expects an object.
namestringRequired
The name of the site
templateNamestringOptional
The workspace or marketplace template to use
parentFolderIdstring or nullOptional

MegaDodo Publications - Potential Book Ideas

Response

Request was successful
idstringformat: "objectid"
Unique identifier for the Site
workspaceIdstringformat: "objectid"
Unique identifier for the Workspace
createdOnstringformat: "date-time"
Date the Site was created
displayNamestring
Name given to Site
shortNamestring
Slugified version of name
lastPublishedstringformat: "date-time"
Date the Site was last published
lastUpdatedstringformat: "date-time"
Date the Site was last updated
previewUrlstringformat: "uri"
URL of a generated image for the given Site
timeZonestring
Site timezone set under Site Settings
dataCollectionEnabledboolean
Indicates if data collection is enabled for the site.
dataCollectionTypeenum
The type of data collection enabled for the site.
Allowed values:
parentFolderIdstring or nullformat: "objectid"
The ID of the parent folder the Site exists in
customDomainslist of objects
localesobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error