POST /sites/{site_id}/publish
Publishes a site or an individual page to one or more domains. If multiple individual pages are published to staging, publishing from staging to production publishes all staged changes.
To publish to a specific custom domain, use the domain IDs from the Get Custom Domains endpoint.
You must include at least one of the customDomains or publishToWebflowSubdomain properties in the request body.
To publish an individual page instead of the entire site, provide the ID of the page in the pageId parameter.
This endpoint has a specific rate limit of one successful publish queue per minute.
Required scope | sites:write
Servers
- https://api.webflow.com/v2
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
site_id |
String | Yes |
Unique identifier for a Site |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
customDomains[] |
Array | No |
Array of Custom Domain IDs to publish |
pageId |
String | No |
The ID of the page to publish |
publishToWebflowSubdomain |
Boolean | No |
Choice of whether to publish to the default Webflow Subdomain Default value: false |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.