Reference

Token

client.token.authorizedBy() -> Webflow.AuthorizedUser

📝 Description

Information about the Authorized User

Required Scope | authorized_user:read

🔌 Usage

await client.token.authorizedBy();

⚙️ Parameters

requestOptions: Token.RequestOptions

client.token.introspect() -> Webflow.Authorization

📝 Description

Information about the authorization token

Access to this endpoint requires a bearer token from a Data Client App.

🔌 Usage

await client.token.introspect();

⚙️ Parameters

requestOptions: Token.RequestOptions

Sites

client.sites.create(workspaceId, { ...params }) -> Webflow.Site

📝 Description

Create a site.

This endpoint requires an Enterprise workspace.

Required scope | workspace:write

🔌 Usage

await client.sites.create("580e63e98c9a982ac9b8b741", {
    name: "The Hitchhiker's Guide to the Galaxy",
});

⚙️ Parameters

workspaceId: string — Unique identifier for a Workspace

request: Webflow.SitesCreateRequest

requestOptions: Sites.RequestOptions

client.sites.list() -> Webflow.Sites

📝 Description

List of all sites the provided access token is able to access.

Required scope | sites:read

🔌 Usage

await client.sites.list();

⚙️ Parameters

requestOptions: Sites.RequestOptions

client.sites.get(siteId) -> Webflow.Site

📝 Description

Get details of a site.

Required scope | sites:read

🔌 Usage

await client.sites.get("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Sites.RequestOptions

client.sites.delete(siteId) -> void

📝 Description

Delete a site.

This endpoint requires an Enterprise workspace.

Required scope | sites:write

🔌 Usage

await client.sites.delete("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Sites.RequestOptions

client.sites.update(siteId, { ...params }) -> Webflow.Site

📝 Description

Update a site.

This endpoint requires an Enterprise workspace.

Required scope | sites:write

🔌 Usage

await client.sites.update("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.SitesUpdateRequest

requestOptions: Sites.RequestOptions

client.sites.getCustomDomain(siteId) -> Webflow.Domains

📝 Description

Get a list of all custom domains related to site.

Required scope | sites:read

🔌 Usage

await client.sites.getCustomDomain("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Sites.RequestOptions

client.sites.publish(siteId, { ...params }) -> Webflow.SitesPublishResponse

📝 Description

Publishes a site to one or more more domains.

This endpoint has a limit of one successful publish queue per minute.

Required scope | sites:write

🔌 Usage

await client.sites.publish("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.SitesPublishRequest

requestOptions: Sites.RequestOptions

Collections

client.collections.list(siteId) -> Webflow.CollectionList

📝 Description

List of all Collections within a Site.

Required scope | cms:read

🔌 Usage

await client.collections.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Collections.RequestOptions

client.collections.create(siteId, { ...params }) -> Webflow.Collection

📝 Description

Create a Collection for a site.

Required scope | cms:write

🔌 Usage

await client.collections.create("580e63e98c9a982ac9b8b741", {
    displayName: "Blog Posts",
    singularName: "Blog Post",
    slug: "posts",
    fields: [
        {
            isRequired: true,
            type: "PlainText",
            displayName: "Title",
            helpText: "The title of the blog post",
        },
        {
            isRequired: true,
            type: "RichText",
            displayName: "Content",
            helpText: "The content of the blog post",
        },
        {
            isRequired: true,
            type: "Reference",
            displayName: "Author",
            helpText: "The author of the blog post",
            metadata: {
                collectionId: "23cc2d952d4e4631ffd4345d2743db4e",
            },
        },
    ],
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.CollectionsCreateRequest

requestOptions: Collections.RequestOptions

client.collections.get(collectionId) -> Webflow.Collection

📝 Description

Get the full details of a collection from its ID.

Required scope | cms:read

🔌 Usage

await client.collections.get("580e63fc8c9a982ac9b8b745");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

requestOptions: Collections.RequestOptions

client.collections.delete(collectionId) -> void

📝 Description

Delete a collection using its ID.

Required scope | cms:write

🔌 Usage

await client.collections.delete("580e63fc8c9a982ac9b8b745");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

requestOptions: Collections.RequestOptions

Pages

client.pages.list(siteId, { ...params }) -> Webflow.PageList

📝 Description

List of all pages for a site.

Required scope | pages:read

🔌 Usage

await client.pages.list("580e63e98c9a982ac9b8b741", {
    localeId: "65427cf400e02b306eaa04a0",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.PagesListRequest

requestOptions: Pages.RequestOptions

client.pages.getMetadata(pageId, { ...params }) -> Webflow.Page

📝 Description

Get metadata information for a single page.

Required scope | pages:read

🔌 Usage

await client.pages.getMetadata("63c720f9347c2139b248e552", {
    localeId: "65427cf400e02b306eaa04a0",
});

⚙️ Parameters

pageId: string — Unique identifier for a Page

request: Webflow.PagesGetMetadataRequest

requestOptions: Pages.RequestOptions

client.pages.updatePageSettings(pageId, { ...params }) -> Webflow.Page

📝 Description

Update Page-level metadata, including SEO and Open Graph fields.

Note: When updating Page Metadata in secondary locales, you may only add `slug` to the request if your Site has the [Advanced or Enterprise Localization](https://webflow.com/localization) add-on.

Required scope | pages:write

🔌 Usage

await client.pages.updatePageSettings("63c720f9347c2139b248e552", {
    localeId: "65427cf400e02b306eaa04a0",
    body: {
        id: "6596da6045e56dee495bcbba",
        siteId: "6258612d1ee792848f805dcf",
        title: "Guide to the Galaxy",
        slug: "guide-to-the-galaxy",
        createdOn: "2024-03-11T10:42:00Z",
        lastUpdated: "2024-03-11T10:42:42Z",
        archived: false,
        draft: false,
        canBranch: true,
        isBranch: false,
        seo: {
            title: "The Ultimate Hitchhiker's Guide to the Galaxy",
            description:
                "Everything you need to know about the galaxy, from avoiding Vogon poetry to the importance of towels.",
        },
        openGraph: {
            title: "Explore the Cosmos with The Ultimate Guide",
            titleCopied: false,
            description: "Dive deep into the mysteries of the universe with your guide to everything galactic.",
            descriptionCopied: false,
        },
        localeId: "653fd9af6a07fc9cfd7a5e57",
        publishedPath: "/en-us/guide-to-the-galaxy",
    },
});

⚙️ Parameters

pageId: string — Unique identifier for a Page

request: Webflow.UpdatePageSettingsRequest

requestOptions: Pages.RequestOptions

client.pages.getContent(pageId, { ...params }) -> Webflow.Dom

📝 Description

Get content from a static page. This includes text nodes, image nodes, and component instances with property overrides.

To retrieve the static content of a component instance, use the Get Component Content endpoint.

If you do not include a localeId in your request, the response will return any content that can be localized from the Primary locale.

Required scope | pages:read

🔌 Usage

await client.pages.getContent("63c720f9347c2139b248e552", {
    localeId: "65427cf400e02b306eaa04a0",
});

⚙️ Parameters

pageId: string — Unique identifier for a Page

request: Webflow.PagesGetContentRequest

requestOptions: Pages.RequestOptions

client.pages.updateStaticContent(pageId, { ...params }) -> Webflow.UpdateStaticContentResponse

📝 Description

This endpoint updates content on a static page in secondary locales. It supports updating up to 1000 nodes in a single request.

Before making updates:

Use the get page content endpoint to identify available content nodes and their types
If the page has component instances, retrieve the component's properties that you'll override using the get component properties endpoint

This endpoint is specifically for localized pages. Ensure that the specified `localeId` is a valid **secondary locale** for the site otherwise the request will fail.

Required scope | pages:write

🔌 Usage

await client.pages.updateStaticContent("63c720f9347c2139b248e552", {
    localeId: "localeId",
    nodes: [
        {
            nodeId: "a245c12d-995b-55ee-5ec7-aa36a6cad623",
            text: "<h1>The Hitchhiker's Guide to the Galaxy</h1>",
        },
        {
            nodeId: "a245c12d-995b-55ee-5ec7-aa36a6cad627",
            text: "<div><h3>Don't Panic!</h3><p>Always know where your towel is.</p></div>",
        },
        {
            nodeId: "a245c12d-995b-55ee-5ec7-aa36a6cad629",
            propertyOverrides: [
                {
                    propertyId: "7dd14c08-2e96-8d3d-2b19-b5c03642a0f0",
                    text: "<div><h1>Time is an <em>illusion</em></h1></div>",
                },
                {
                    propertyId: "7dd14c08-2e96-8d3d-2b19-b5c03642a0f1",
                    text: "Life, the Universe and Everything",
                },
            ],
        },
    ],
});

⚙️ Parameters

pageId: string — Unique identifier for a Page

request: Webflow.PageDomWrite

requestOptions: Pages.RequestOptions

Components

client.components.list(siteId, { ...params }) -> Webflow.ComponentList

📝 Description

List of all components for a site.

Required scope | components:read

🔌 Usage

await client.components.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.ComponentsListRequest

requestOptions: Components.RequestOptions

client.components.getContent(siteId, componentId, { ...params }) -> Webflow.ComponentDom

📝 Description

Get static content from a component definition. This includes text nodes, image nodes and nested component instances. To retrieve dynamic content set by component properties, use the get component properties endpoint.

If you do not provide a Locale ID in your request, the response will return any content that can be localized from the Primary locale.

Required scope | components:read

🔌 Usage

await client.components.getContent("580e63e98c9a982ac9b8b741", "8505ba55-ef72-629e-f85c-33e4b703d48b", {
    localeId: "65427cf400e02b306eaa04a0",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

componentId: string — Unique identifier for a Component

request: Webflow.ComponentsGetContentRequest

requestOptions: Components.RequestOptions

client.components.updateContent(siteId, componentId, { ...params }) -> Webflow.ComponentsUpdateContentResponse

📝 Description

This endpoint updates content within a component defintion for secondary locales. It supports updating up to 1000 nodes in a single request.

Before making updates:

Use the get component content endpoint to identify available content nodes and their types
If your component definition has a component instance nested within it, retrieve the nested component instance's properties that you'll override using the get component properties endpoint

This endpoint is specifically for localizing component definitions. Ensure that the specified `localeId` is a valid **secondary locale** for the site otherwise the request will fail.

Required scope | components:write

🔌 Usage

await client.components.updateContent("580e63e98c9a982ac9b8b741", "8505ba55-ef72-629e-f85c-33e4b703d48b", {
    localeId: "65427cf400e02b306eaa04a0",
    nodes: [
        {
            nodeId: "a245c12d-995b-55ee-5ec7-aa36a6cad623",
            text: "<h1>The Hitchhiker's Guide to the Galaxy</h1>",
        },
        {
            nodeId: "a245c12d-995b-55ee-5ec7-aa36a6cad627",
            text: "<div><h3>Don't Panic!</h3><p>Always know where your towel is.</p></div>",
        },
        {
            nodeId: "a245c12d-995b-55ee-5ec7-aa36a6cad629",
            propertyOverrides: [
                {
                    propertyId: "7dd14c08-2e96-8d3d-2b19-b5c03642a0f0",
                    text: "<div><h1>Time is an <em>illusion</em></h1></div>",
                },
                {
                    propertyId: "7dd14c08-2e96-8d3d-2b19-b5c03642a0f1",
                    text: "Life, the Universe and Everything",
                },
            ],
        },
    ],
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

componentId: string — Unique identifier for a Component

request: Webflow.ComponentDomWrite

requestOptions: Components.RequestOptions

client.components.getProperties(siteId, componentId, { ...params }) -> Webflow.ComponentProperties

📝 Description

Get the default property values of a component definition.

If you do not include a localeId in your request, the response will return any properties that can be localized from the Primary locale.

Required scope | components:read

🔌 Usage

await client.components.getProperties("580e63e98c9a982ac9b8b741", "8505ba55-ef72-629e-f85c-33e4b703d48b", {
    localeId: "65427cf400e02b306eaa04a0",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

componentId: string — Unique identifier for a Component

request: Webflow.ComponentsGetPropertiesRequest

requestOptions: Components.RequestOptions

client.components.updateProperties(siteId, componentId, { ...params }) -> Webflow.ComponentsUpdatePropertiesResponse

📝 Description

Update the default property values of a component definition in a specificed locale.

Before making updates, use the get component properties endpoint to identify properties that can be updated in a secondary locale.

The request requires a secondary locale ID. If a localeId is missing, the request will not be processed and will result in an error.

Required scope | components:write

🔌 Usage

await client.components.updateProperties("580e63e98c9a982ac9b8b741", "8505ba55-ef72-629e-f85c-33e4b703d48b", {
    localeId: "65427cf400e02b306eaa04a0",
    properties: [
        {
            propertyId: "a245c12d-995b-55ee-5ec7-aa36a6cad623",
            text: "The Hitchhiker\u2019s Guide to the Galaxy",
        },
        {
            propertyId: "a245c12d-995b-55ee-5ec7-aa36a6cad627",
            text: "<div><h3>Dont Panic!</h3><p>Always know where your towel is.</p></div>",
        },
    ],
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

componentId: string — Unique identifier for a Component

request: Webflow.ComponentPropertiesWrite

requestOptions: Components.RequestOptions

Scripts

client.scripts.list(siteId) -> Webflow.RegisteredScriptList

📝 Description

Get a list of scripts that have been registered to a site. A site can have a maximum of 800 registered scripts.

To apply a script to a site or page, the script must first be registered to a site via the [Register Script](/data/reference/custom-code/custom-code/register-hosted) endpoints. Once registered, the script can be applied to a Site or Page using the appropriate endpoints. See the documentation on [working with Custom Code](/data/docs/custom-code) for more information.

Required scope | custom_code:read

🔌 Usage

await client.scripts.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Scripts.RequestOptions

client.scripts.registerHosted(siteId, { ...params }) -> Webflow.CustomCodeHostedResponse

📝 Description

Register a hosted script to a site.

To apply a script to a site or page, the script must first be registered to a site via the [Register Script](/data/reference/custom-code/custom-code/register-hosted) endpoints. Once registered, the script can be applied to a Site or Page using the appropriate endpoints. See the documentation on [working with Custom Code](/data/docs/custom-code) for more information.

Required scope | custom_code:write

🔌 Usage

await client.scripts.registerHosted("580e63e98c9a982ac9b8b741", {
    hostedLocation: "hostedLocation",
    integrityHash: "integrityHash",
    version: "version",
    displayName: "displayName",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.CustomCodeHostedRequest

requestOptions: Scripts.RequestOptions

client.scripts.registerInline(siteId, { ...params }) -> Webflow.CustomCodeInlineResponse

📝 Description

Register an inline script to a site. Inline scripts are limited to 2000 characters.

To apply a script to a site or page, the script must first be registered to a site via the [Register Script](/data/reference/custom-code/custom-code/register-hosted) endpoints. Once registered, the script can be applied to a Site or Page using the appropriate endpoints. See the documentation on [working with Custom Code](/data/docs/custom-code) for more information.

Required scope | custom_code:write

🔌 Usage

await client.scripts.registerInline("580e63e98c9a982ac9b8b741", {
    sourceCode: "alert('hello world');",
    version: "0.0.1",
    displayName: "Alert",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.CustomCodeInlineRequest

requestOptions: Scripts.RequestOptions

Assets

client.assets.list(siteId) -> Webflow.Assets

📝 Description

List of assets uploaded to a site

Required scope | assets:read

🔌 Usage

await client.assets.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Assets.RequestOptions

client.assets.create(siteId, { ...params }) -> Webflow.AssetUpload

📝 Description

The first step in uploading an asset to a site.

This endpoint generates a response with the following information: uploadUrl and uploadDetails.

Use these properties in the header of a POST request to Amazson s3 to complete the upload.

To learn more about how to upload assets to Webflow, see our assets guide.

Required scope | assets:write

🔌 Usage

await client.assets.create("580e63e98c9a982ac9b8b741", {
    fileName: "file.png",
    fileHash: "3c7d87c9575702bc3b1e991f4d3c638e",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.AssetsCreateRequest

requestOptions: Assets.RequestOptions

client.assets.get(assetId) -> Webflow.Asset

📝 Description

Get details about an asset

Required scope | assets:read

🔌 Usage

await client.assets.get("580e63fc8c9a982ac9b8b745");

⚙️ Parameters

assetId: string — Unique identifier for an Asset on a site

requestOptions: Assets.RequestOptions

client.assets.delete(assetId) -> void

📝 Description

Delete an Asset

Required Scope: assets: write

🔌 Usage

await client.assets.delete("580e63fc8c9a982ac9b8b745");

⚙️ Parameters

assetId: string — Unique identifier for an Asset on a site

requestOptions: Assets.RequestOptions

client.assets.update(assetId, { ...params }) -> Webflow.Asset

📝 Description

Update details of an Asset.

Required scope | assets:write

🔌 Usage

await client.assets.update("580e63fc8c9a982ac9b8b745");

⚙️ Parameters

assetId: string — Unique identifier for an Asset on a site

request: Webflow.AssetsUpdateRequest

requestOptions: Assets.RequestOptions

client.assets.listFolders(siteId) -> Webflow.AssetFolderList

📝 Description

List Asset Folders within a given site

Required scope | assets:read

🔌 Usage

await client.assets.listFolders("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Assets.RequestOptions

client.assets.createFolder(siteId, { ...params }) -> Webflow.AssetFolder

📝 Description

Create an Asset Folder within a given site

Required scope | assets:write

🔌 Usage

await client.assets.createFolder("580e63e98c9a982ac9b8b741", {
    displayName: "my asset folder",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.AssetsCreateFolderRequest

requestOptions: Assets.RequestOptions

client.assets.getFolder(assetFolderId) -> Webflow.AssetFolder

📝 Description

Get details about a specific Asset Folder

Required scope | assets:read

🔌 Usage

await client.assets.getFolder("6390c49774a71f0e3c1a08ee");

⚙️ Parameters

assetFolderId: string — Unique identifier for an Asset Folder

requestOptions: Assets.RequestOptions

Webhooks

client.webhooks.list(siteId) -> Webflow.WebhookList

📝 Description

List all App-created Webhooks registered for a given site

Required scope | sites:read

🔌 Usage

await client.webhooks.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Webhooks.RequestOptions

client.webhooks.create(siteId, { ...params }) -> Webflow.Webhook

📝 Description

Create a new Webhook.

Limit of 75 registrations per triggerType, per site.

Access to this endpoint requires a bearer token from a Data Client App. Required scope | sites:write

🔌 Usage

await client.webhooks.create("580e63e98c9a982ac9b8b741", {
    id: "582266e0cd48de0f0e3c6d8b",
    triggerType: "form_submission",
    url: "https://webhook.site/7f7f7f7f-7f7f-7f7f-7f7f-7f7f7f7f7f7f",
    workspaceId: "4f4e46fd476ea8c507000001",
    siteId: "562ac0395358780a1f5e6fbd",
    lastTriggered: "2023-02-08T23:59:28Z",
    createdOn: "2022-11-08T23:59:28Z",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.Webhook

requestOptions: Webhooks.RequestOptions

client.webhooks.get(webhookId) -> Webflow.Webhook

📝 Description

Get a specific Webhook instance

Required scope: sites:read

🔌 Usage

await client.webhooks.get("580e64008c9a982ac9b8b754");

⚙️ Parameters

webhookId: string — Unique identifier for a Webhook

requestOptions: Webhooks.RequestOptions

client.webhooks.delete(webhookId) -> void

📝 Description

Remove a Webhook

Required scope: sites:read

🔌 Usage

await client.webhooks.delete("580e64008c9a982ac9b8b754");

⚙️ Parameters

webhookId: string — Unique identifier for a Webhook

requestOptions: Webhooks.RequestOptions

Forms

client.forms.list(siteId, { ...params }) -> Webflow.FormList

📝 Description

List forms for a given site.

Required scope | forms:read

🔌 Usage

await client.forms.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.FormsListRequest

requestOptions: Forms.RequestOptions

client.forms.get(formId) -> Webflow.Form

📝 Description

Get information about a given form.

Required scope | forms:read

🔌 Usage

await client.forms.get("580e63e98c9a982ac9b8b741");

⚙️ Parameters

formId: string — Unique identifier for a Form

requestOptions: Forms.RequestOptions

client.forms.listSubmissions(formId, { ...params }) -> Webflow.FormSubmissionList

📝 Description

List form submissions for a given form

When a form is used in a component definition, each instance of the form is considered a unique form.

To get a combined list of submissions for a form that appears across multiple component instances, use the List Form Submissions by Site endpoint.

Required scope | forms:read

🔌 Usage

await client.forms.listSubmissions("580e63e98c9a982ac9b8b741");

⚙️ Parameters

formId: string — Unique identifier for a Form

request: Webflow.FormsListSubmissionsRequest

requestOptions: Forms.RequestOptions

client.forms.getSubmission(formSubmissionId) -> Webflow.FormSubmission

📝 Description

Get information about a given form submissio.

Required scope | forms:read

🔌 Usage

await client.forms.getSubmission("580e63e98c9a982ac9b8b741");

⚙️ Parameters

formSubmissionId: string — Unique identifier for a Form Submission

requestOptions: Forms.RequestOptions

client.forms.deleteSubmission(formSubmissionId) -> void

📝 Description

Delete a form submission

Required scope | forms:write

🔌 Usage

await client.forms.deleteSubmission("580e63e98c9a982ac9b8b741");

⚙️ Parameters

formSubmissionId: string — Unique identifier for a Form Submission

requestOptions: Forms.RequestOptions

client.forms.updateSubmission(formSubmissionId, { ...params }) -> Webflow.FormSubmission

📝 Description

Update hidden fields on a form submission

Required scope | forms:write

🔌 Usage

await client.forms.updateSubmission("580e63e98c9a982ac9b8b741");

⚙️ Parameters

formSubmissionId: string — Unique identifier for a Form Submission

request: Webflow.FormsUpdateSubmissionRequest

requestOptions: Forms.RequestOptions

client.forms.listSubmissionsBySite(siteId, { ...params }) -> Webflow.FormSubmissionList

📝 Description

List form submissions for a given site. This endpoint differs from the existing List Form Submissions endpoint by accepting siteId as a path parameter and elementId as a query parameter. You can get the elementId from the List forms endpoint.

Required scope | forms:read

🔌 Usage

await client.forms.listSubmissionsBySite("580e63e98c9a982ac9b8b741", {
    elementId: "18259716-3e5a-646a-5f41-5dc4b9405aa0",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.FormsListSubmissionsBySiteRequest

requestOptions: Forms.RequestOptions

Users

client.users.list(siteId, { ...params }) -> Webflow.UserList

📝 Description

Get a list of users for a site

Required scope | users:read

🔌 Usage

await client.users.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.UsersListRequest

requestOptions: Users.RequestOptions

client.users.get(siteId, userId) -> Webflow.User

📝 Description

Get a User by ID

Required scope | users:read

🔌 Usage

await client.users.get("580e63e98c9a982ac9b8b741", "580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

userId: string — Unique identifier for a User

requestOptions: Users.RequestOptions

client.users.delete(siteId, userId) -> void

📝 Description

Delete a User by ID

Required scope | users:write

🔌 Usage

await client.users.delete("580e63e98c9a982ac9b8b741", "580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

userId: string — Unique identifier for a User

requestOptions: Users.RequestOptions

client.users.update(siteId, userId, { ...params }) -> Webflow.User

📝 Description

Update a User by ID

Required scope | users:write

The email and password fields cannot be updated using this endpoint

🔌 Usage

await client.users.update("580e63e98c9a982ac9b8b741", "580e63e98c9a982ac9b8b741", {
    data: {
        name: "Some One",
        acceptPrivacy: false,
        acceptCommunications: false,
    },
    accessGroups: ["webflowers", "platinum", "free-tier"],
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

userId: string — Unique identifier for a User

request: Webflow.UsersUpdateRequest

requestOptions: Users.RequestOptions

client.users.invite(siteId, { ...params }) -> Webflow.User

📝 Description

Create and invite a user with an email address.

The user will be sent and invite via email, which they will need to accept in order to join paid any paid access group.

Required scope | users:write

🔌 Usage

await client.users.invite("580e63e98c9a982ac9b8b741", {
    email: "some.one@home.com",
    accessGroups: ["webflowers"],
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.UsersInviteRequest

requestOptions: Users.RequestOptions

AccessGroups

client.accessGroups.list(siteId, { ...params }) -> Webflow.AccessGroupList

📝 Description

Get a list of access groups for a site

Required scope | users:read

🔌 Usage

await client.accessGroups.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.AccessGroupsListRequest

requestOptions: AccessGroups.RequestOptions

Products

client.products.list(siteId, { ...params }) -> Webflow.ProductAndSkUsList

📝 Description

Retrieve all products for a site.

Use limit and offset to page through all products with subsequent requests. All SKUs for each product will also be fetched and returned. The limit, offset and total values represent Products only and do not include any SKUs.

Required scope | ecommerce:read

🔌 Usage

await client.products.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.ProductsListRequest

requestOptions: Products.RequestOptions

client.products.create(siteId, { ...params }) -> Webflow.ProductAndSkUs

📝 Description

Create a new product and SKU.

When you create a product, you will always create a SKU, since a Product Item must have, at minimum, a single SKU.

To create a Product with multiple SKUs - for example a T-shirt in sizes small, medium and large:

Create parameters in sku-properties, also known as product options and variants..
A single sku-property would be color. Within the color property, list the various colors of T-shirts as an array of enum values: royal-blue, crimson-red, and forrest-green.
Once, you've created a Product and its sku-properties with enum values, Webflow will create a default SKU, which will automatically be a combination of the first sku-properties you've created.
In our example, the default SKU will be a Royal Blue T-Shirt, because our first enum of our Color sku-property is Royal Blue.
After you've created your product, you can create additional SKUs using the Create SKU endpoint.

Upon creation, the default product type will be Advanced, which ensures all Product and SKU fields will be shown to users in the Designer.

Required scope | ecommerce:write

🔌 Usage

await client.products.create("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.ProductSkuCreate

requestOptions: Products.RequestOptions

client.products.get(siteId, productId) -> Webflow.ProductAndSkUs

📝 Description

Retrieve a single product by its ID. All of its SKUs will also be retrieved.

Required scope | ecommerce:read

🔌 Usage

await client.products.get("580e63e98c9a982ac9b8b741", "580e63fc8c9a982ac9b8b745");

⚙️ Parameters

siteId: string — Unique identifier for a Site

productId: string — Unique identifier for a Product

requestOptions: Products.RequestOptions

client.products.update(siteId, productId, { ...params }) -> Webflow.Product

📝 Description

Update an existing Product.

Updating an existing Product will set the product type to Advanced, which ensures all Product and SKU fields will be shown to users in the Designer.

Required scope | ecommerce:write

🔌 Usage

await client.products.update("580e63e98c9a982ac9b8b741", "580e63fc8c9a982ac9b8b745");

⚙️ Parameters

siteId: string — Unique identifier for a Site

productId: string — Unique identifier for a Product

request: Webflow.ProductSkuUpdate

requestOptions: Products.RequestOptions

client.products.createSku(siteId, productId, { ...params }) -> Webflow.ProductsCreateSkuResponse

📝 Description

Create additional SKUs to manage every option and variant of your Product.

Creating SKUs through the API will set the product type to Advanced, which ensures all Product and SKU fields will be shown to users in the Designer.

Required scope | ecommerce:write

🔌 Usage

await client.products.createSku("580e63e98c9a982ac9b8b741", "580e63fc8c9a982ac9b8b745", {
    skus: [{}],
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

productId: string — Unique identifier for a Product

request: Webflow.ProductsCreateSkuRequest

requestOptions: Products.RequestOptions

client.products.updateSku(siteId, productId, skuId, { ...params }) -> Webflow.Sku

📝 Description

Update a specified SKU.

Updating an existing SKU will set the Product type to Advanced, which ensures all Product and SKU fields will be shown to users in the Designer.

Required scope | ecommerce:write

🔌 Usage

await client.products.updateSku("580e63e98c9a982ac9b8b741", "580e63fc8c9a982ac9b8b745", "5e8518516e147040726cc415", {
    sku: {},
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

productId: string — Unique identifier for a Product

skuId: string — Unique identifier for a SKU

request: Webflow.ProductsUpdateSkuRequest

requestOptions: Products.RequestOptions

Orders

client.orders.list(siteId, { ...params }) -> Webflow.OrderList

📝 Description

List all orders created for a given site.

Required scope | ecommerce:read

🔌 Usage

await client.orders.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.OrdersListRequest

requestOptions: Orders.RequestOptions

client.orders.get(siteId, orderId) -> Webflow.Order

📝 Description

Retrieve a single product by its ID. All of its SKUs will also be retrieved.

Required scope | ecommerce:read

🔌 Usage

await client.orders.get("580e63e98c9a982ac9b8b741", "5e8518516e147040726cc415");

⚙️ Parameters

siteId: string — Unique identifier for a Site

orderId: string — Unique identifier for an Order

requestOptions: Orders.RequestOptions

client.orders.update(siteId, orderId, { ...params }) -> Webflow.Order

📝 Description

This API lets you update the fields, comment, shippingProvider, and/or shippingTracking for a given order. All three fields can be updated simultaneously or independently.

Required scope | ecommerce:write

🔌 Usage

await client.orders.update("580e63e98c9a982ac9b8b741", "5e8518516e147040726cc415");

⚙️ Parameters

siteId: string — Unique identifier for a Site

orderId: string — Unique identifier for an Order

request: Webflow.OrdersUpdateRequest

requestOptions: Orders.RequestOptions

client.orders.updateFulfill(siteId, orderId, { ...params }) -> Webflow.Order

📝 Description

Updates an order's status to fulfilled

Required scope | ecommerce:write

🔌 Usage

await client.orders.updateFulfill("580e63e98c9a982ac9b8b741", "5e8518516e147040726cc415");

⚙️ Parameters

siteId: string — Unique identifier for a Site

orderId: string — Unique identifier for an Order

request: Webflow.OrdersUpdateFulfillRequest

requestOptions: Orders.RequestOptions

client.orders.updateUnfulfill(siteId, orderId) -> Webflow.Order

📝 Description

Updates an order's status to unfulfilled

Required scope | ecommerce:write

🔌 Usage

await client.orders.updateUnfulfill("580e63e98c9a982ac9b8b741", "5e8518516e147040726cc415");

⚙️ Parameters

siteId: string — Unique identifier for a Site

orderId: string — Unique identifier for an Order

requestOptions: Orders.RequestOptions

client.orders.refund(siteId, orderId, { ...params }) -> Webflow.Order

📝 Description

This API will reverse a Stripe charge and refund an order back to a customer. It will also set the order's status to refunded.

Required scope | ecommerce:write

🔌 Usage

await client.orders.refund("580e63e98c9a982ac9b8b741", "5e8518516e147040726cc415");

⚙️ Parameters

siteId: string — Unique identifier for a Site

orderId: string — Unique identifier for an Order

request: Webflow.OrdersRefundRequest

requestOptions: Orders.RequestOptions

Inventory

client.inventory.list(collectionId, itemId) -> Webflow.InventoryItem

📝 Description

List the current inventory levels for a particular SKU item.

Required scope | ecommerce:read

🔌 Usage

await client.inventory.list("580e63fc8c9a982ac9b8b745", "580e64008c9a982ac9b8b754");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

itemId: string — Unique identifier for an Item

requestOptions: Inventory.RequestOptions

client.inventory.update(collectionId, itemId, { ...params }) -> Webflow.InventoryItem

📝 Description

Updates the current inventory levels for a particular SKU item.

Updates may be given in one or two methods, absolutely or incrementally.

Absolute updates are done by setting quantity directly.
Incremental updates are by specifying the inventory delta in updateQuantity which is then added to the quantity stored on the server.

Required scope | ecommerce:write

🔌 Usage

await client.inventory.update("580e63fc8c9a982ac9b8b745", "580e64008c9a982ac9b8b754", {
    inventoryType: "infinite",
});

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

itemId: string — Unique identifier for an Item

request: Webflow.InventoryUpdateRequest

requestOptions: Inventory.RequestOptions

Ecommerce

client.ecommerce.getSettings(siteId) -> Webflow.EcommerceSettings

📝 Description

Retrieve ecommerce settings for a site.

Required scope | ecommerce:read

🔌 Usage

await client.ecommerce.getSettings("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Ecommerce.RequestOptions

Collections Fields

client.collections.fields.create(collectionId, { ...params }) -> Webflow.FieldCreate

📝 Description

Create a custom field in a collection.

Slugs must be all lowercase letters without spaces. If you pass a string with uppercase letters and/or spaces to the "Slug" property, Webflow will convert the slug to lowercase and replace spaces with "-." This endpoint does not currently support bulk creation.

Required scope | cms:write

🔌 Usage

await client.collections.fields.create("580e63fc8c9a982ac9b8b745", {
    isEditable: true,
    isRequired: false,
    type: "RichText",
    displayName: "Post Body",
    helpText: "Add the body of your post here",
});

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

request: Webflow.FieldCreate

requestOptions: Fields.RequestOptions

client.collections.fields.delete(collectionId, fieldId) -> void

📝 Description

Delete a custom field in a collection. This endpoint does not currently support bulk deletion.

Required scope | cms:write

🔌 Usage

await client.collections.fields.delete("580e63fc8c9a982ac9b8b745", "580e63fc8c9a982ac9b8b745");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

fieldId: string — Unique identifier for a Field in a collection

requestOptions: Fields.RequestOptions

client.collections.fields.update(collectionId, fieldId, { ...params }) -> Webflow.Field

📝 Description

Update a custom field in a collection.

Required scope | cms:write

🔌 Usage

await client.collections.fields.update("580e63fc8c9a982ac9b8b745", "580e63fc8c9a982ac9b8b745", {
    isRequired: false,
    displayName: "Post Body",
    helpText: "Add the body of your post here",
});

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

fieldId: string — Unique identifier for a Field in a collection

request: Webflow.collections.FieldUpdate

requestOptions: Fields.RequestOptions

Collections Items

client.collections.items.listItems(collectionId, { ...params }) -> Webflow.CollectionItemList

📝 Description

List of all Items within a Collection.

Required scope | CMS:read

🔌 Usage

await client.collections.items.listItems("580e63fc8c9a982ac9b8b745");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

request: Webflow.collections.ItemsListItemsRequest

requestOptions: Items.RequestOptions

client.collections.items.createItem(collectionId, { ...params }) -> Webflow.CollectionItem

📝 Description

Create Item(s) in a Collection.

To create items across multiple locales, please use this endpoint.

Required scope | CMS:write

🔌 Usage

await client.collections.items.createItem("580e63fc8c9a982ac9b8b745", {
    isArchived: false,
    isDraft: false,
    fieldData: {
        name: "Pan Galactic Gargle Blaster Recipe",
        slug: "pan-galactic-gargle-blaster",
    },
});

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

request: Webflow.ItemsCreateItemRequest

requestOptions: Items.RequestOptions

client.collections.items.deleteItems(collectionId, { ...params }) -> void

📝 Description

Delete Items from a Collection.

Items will only be deleted in the primary locale unless a cmsLocaleId is included in the request.

Required scope | CMS:write

🔌 Usage

await client.collections.items.deleteItems("580e63fc8c9a982ac9b8b745");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

request: Webflow.collections.ItemsDeleteItemsRequest

requestOptions: Items.RequestOptions

client.collections.items.updateItems(collectionId, { ...params }) -> Webflow.CollectionItem

📝 Description

Update a single item or multiple items in a Collection.

The limit for this endpoint is 100 items.

Items will only be updated in the primary locale, unless a cmsLocaleId is included in the request.

Required scope | CMS:write

🔌 Usage

await client.collections.items.updateItems("580e63fc8c9a982ac9b8b745", {
    items: [
        {
            id: "66f6ed9576ddacf3149d5ea6",
            cmsLocaleId: "66f6e966c9e1dc700a857ca5",
            fieldData: {
                name: "Ne Paniquez Pas",
                slug: "ne-paniquez-pas",
            },
        },
        {
            id: "66f6ed9576ddacf3149d5ea6",
            cmsLocaleId: "66f6e966c9e1dc700a857ca4",
            fieldData: {
                name: "No Entrar en P\u00E1nico",
                slug: "no-entrar-en-panico",
            },
        },
        {
            id: "66f6ed9576ddacf3149d5eaa",
            cmsLocaleId: "66f6e966c9e1dc700a857ca5",
            fieldData: {
                name: "Au Revoir et Merci pour Tous les Poissons",
                slug: "au-revoir-et-merci",
            },
        },
        {
            id: "66f6ed9576ddacf3149d5eaa",
            cmsLocaleId: "66f6e966c9e1dc700a857ca4",
            fieldData: {
                name: "Hasta Luego y Gracias por Todo el Pescado",
                slug: "hasta-luego-y-gracias",
            },
        },
    ],
});

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

request: Webflow.collections.ItemsUpdateItemsRequest

requestOptions: Items.RequestOptions

client.collections.items.listItemsLive(collectionId, { ...params }) -> Webflow.CollectionItemList

📝 Description

List all published items in a collection.

Required scope | CMS:read

🔌 Usage

await client.collections.items.listItemsLive("580e63fc8c9a982ac9b8b745");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

request: Webflow.collections.ItemsListItemsLiveRequest

requestOptions: Items.RequestOptions

client.collections.items.createItemLive(collectionId, { ...params }) -> Webflow.CollectionItem

📝 Description

Create item(s) in a collection that will be immediately published to the live site.

To create items across multiple locales, please use this endpoint.

Required scope | CMS:write

🔌 Usage

await client.collections.items.createItemLive("580e63fc8c9a982ac9b8b745", {
    isArchived: false,
    isDraft: false,
    fieldData: {
        name: "Pan Galactic Gargle Blaster Recipe",
        slug: "pan-galactic-gargle-blaster",
    },
});

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

request: Webflow.ItemsCreateItemLiveRequest

requestOptions: Items.RequestOptions

client.collections.items.deleteItemsLive(collectionId, { ...params }) -> void

📝 Description

Remove an item or multiple items (up to 100 items) from the live site.

Using this endpoint to delete published item(s) will unpublish the item(s) from the live site and set the item(s) isDraft property to true.

Items will only be unpublished in the primary locale unless a cmsLocaleId is included in the request.

Required scope | CMS:write

🔌 Usage

await client.collections.items.deleteItemsLive("580e63fc8c9a982ac9b8b745");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

request: Webflow.collections.ItemsDeleteItemsLiveRequest

requestOptions: Items.RequestOptions

client.collections.items.updateItemsLive(collectionId, { ...params }) -> Webflow.CollectionItemListNoPagination

📝 Description

Update a single published item or multiple published items (up to 100) in a Collection

Items will only be updated in the primary locale, unless a cmsLocaleId is included in the request.

Required scope | CMS:write

🔌 Usage

await client.collections.items.updateItemsLive("580e63fc8c9a982ac9b8b745", {
    items: [
        {
            id: "66f6ed9576ddacf3149d5ea6",
            cmsLocaleId: "66f6e966c9e1dc700a857ca5",
            fieldData: {
                name: "Ne Paniquez Pas",
                slug: "ne-paniquez-pas",
            },
        },
        {
            id: "66f6ed9576ddacf3149d5ea6",
            cmsLocaleId: "66f6e966c9e1dc700a857ca4",
            fieldData: {
                name: "No Entrar en P\u00E1nico",
                slug: "no-entrar-en-panico",
            },
        },
        {
            id: "66f6ed9576ddacf3149d5eaa",
            cmsLocaleId: "66f6e966c9e1dc700a857ca5",
            fieldData: {
                name: "Au Revoir et Merci pour Tous les Poissons",
                slug: "au-revoir-et-merci",
            },
        },
        {
            id: "66f6ed9576ddacf3149d5eaa",
            cmsLocaleId: "66f6e966c9e1dc700a857ca4",
            fieldData: {
                name: "Hasta Luego y Gracias por Todo el Pescado",
                slug: "hasta-luego-y-gracias",
            },
        },
    ],
});

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

request: Webflow.collections.ItemsUpdateItemsLiveRequest

requestOptions: Items.RequestOptions

client.collections.items.createItems(collectionId, { ...params }) -> Webflow.BulkCollectionItem

📝 Description

Create an item or multiple items in a CMS Collection across multiple corresponding locales.

- This endpoint can create up to 100 items in a request. - If the `cmsLocaleIds` parameter is not included in the request, an item will only be created in the primary locale.

Required scope | CMS:write

🔌 Usage

await client.collections.items.createItems("580e63fc8c9a982ac9b8b745", {
    cmsLocaleIds: ["66f6e966c9e1dc700a857ca3", "66f6e966c9e1dc700a857ca4", "66f6e966c9e1dc700a857ca5"],
    isArchived: false,
    isDraft: false,
    fieldData: {
        name: "Don\u2019t Panic",
        slug: "dont-panic",
    },
});

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

request: Webflow.collections.CreateBulkCollectionItemRequestBody

requestOptions: Items.RequestOptions

client.collections.items.getItem(collectionId, itemId, { ...params }) -> Webflow.CollectionItem

📝 Description

Get details of a selected Collection Item.

Required scope | CMS:read

🔌 Usage

await client.collections.items.getItem("580e63fc8c9a982ac9b8b745", "580e64008c9a982ac9b8b754");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

itemId: string — Unique identifier for an Item

request: Webflow.collections.ItemsGetItemRequest

requestOptions: Items.RequestOptions

client.collections.items.deleteItem(collectionId, itemId, { ...params }) -> void

📝 Description

Delete an item from a collection.

Required scope | CMS:write

🔌 Usage

await client.collections.items.deleteItem("580e63fc8c9a982ac9b8b745", "580e64008c9a982ac9b8b754");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

itemId: string — Unique identifier for an Item

request: Webflow.collections.ItemsDeleteItemRequest

requestOptions: Items.RequestOptions

client.collections.items.updateItem(collectionId, itemId, { ...params }) -> Webflow.CollectionItem

📝 Description

Update a selected Item in a Collection.

Required scope | CMS:write

🔌 Usage

await client.collections.items.updateItem("580e63fc8c9a982ac9b8b745", "580e64008c9a982ac9b8b754", {
    isArchived: false,
    isDraft: false,
    fieldData: {
        name: "Pan Galactic Gargle Blaster Recipe",
        slug: "pan-galactic-gargle-blaster",
    },
});

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

itemId: string — Unique identifier for an Item

request: Webflow.CollectionItemPatchSingle

requestOptions: Items.RequestOptions

client.collections.items.getItemLive(collectionId, itemId, { ...params }) -> Webflow.CollectionItem

📝 Description

Get details of a selected Collection live Item.

Required scope | CMS:read

🔌 Usage

await client.collections.items.getItemLive("580e63fc8c9a982ac9b8b745", "580e64008c9a982ac9b8b754");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

itemId: string — Unique identifier for an Item

request: Webflow.collections.ItemsGetItemLiveRequest

requestOptions: Items.RequestOptions

client.collections.items.deleteItemLive(collectionId, itemId, { ...params }) -> void

📝 Description

Remove a live item from the site. Removing a published item will unpublish the item from the live site and set it to draft.

This endpoint does not currently support bulk deletion.

Required scope | CMS:write

🔌 Usage

await client.collections.items.deleteItemLive("580e63fc8c9a982ac9b8b745", "580e64008c9a982ac9b8b754");

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

itemId: string — Unique identifier for an Item

request: Webflow.collections.ItemsDeleteItemLiveRequest

requestOptions: Items.RequestOptions

client.collections.items.updateItemLive(collectionId, itemId, { ...params }) -> Webflow.CollectionItem

📝 Description

Update a selected live Item in a Collection. The updates for this Item will be published to the live site.

Required scope | CMS:write

🔌 Usage

await client.collections.items.updateItemLive("580e63fc8c9a982ac9b8b745", "580e64008c9a982ac9b8b754", {
    isArchived: false,
    isDraft: false,
    fieldData: {
        name: "Pan Galactic Gargle Blaster Recipe",
        slug: "pan-galactic-gargle-blaster",
    },
});

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

itemId: string — Unique identifier for an Item

request: Webflow.CollectionItemPatchSingle

requestOptions: Items.RequestOptions

client.collections.items.publishItem(collectionId, { ...params }) -> Webflow.ItemsPublishItemResponse

📝 Description

Publish an item or multiple items.

Required scope | cms:write

🔌 Usage

await client.collections.items.publishItem("580e63fc8c9a982ac9b8b745", {
    itemIds: ["itemIds"],
});

⚙️ Parameters

collectionId: string — Unique identifier for a Collection

request: Webflow.collections.ItemsPublishItemRequest

requestOptions: Items.RequestOptions

Pages Scripts

client.pages.scripts.getCustomCode(pageId) -> Webflow.ScriptApplyList

📝 Description

Get all scripts applied to a page.

Required scope | custom_code:read

🔌 Usage

await client.pages.scripts.getCustomCode("63c720f9347c2139b248e552");

⚙️ Parameters

pageId: string — Unique identifier for a Page

requestOptions: Scripts.RequestOptions

client.pages.scripts.upsertCustomCode(pageId, { ...params }) -> Webflow.ScriptApplyList

📝 Description

Apply scripts to a page.

To apply a script to a page, the script must first be registered to a Site via the [Register Script](/data/reference/custom-code/custom-code/register-hosted) endpoints. Once registered, the script can be applied to a Site or Page using the appropriate endpoints. See the documentation on [working with Custom Code](/data/docs/custom-code) for more information.

Required scope | custom_code:write

🔌 Usage

await client.pages.scripts.upsertCustomCode("63c720f9347c2139b248e552", {
    scripts: [
        {
            id: "cms_slider",
            location: "header",
            version: "1.0.0",
            attributes: {
                "my-attribute": "some-value",
            },
        },
        {
            id: "alert",
            location: "header",
            version: "0.0.1",
        },
    ],
});

⚙️ Parameters

pageId: string — Unique identifier for a Page

request: Webflow.ScriptApplyList

requestOptions: Scripts.RequestOptions

client.pages.scripts.deleteCustomCode(pageId) -> void

📝 Description

Delete a custom code block that the App created on a page.

Access to this endpoint requires a bearer token from a Data Client App.

Required scope | custom_code:write

🔌 Usage

await client.pages.scripts.deleteCustomCode("63c720f9347c2139b248e552");

⚙️ Parameters

pageId: string — Unique identifier for a Page

requestOptions: Scripts.RequestOptions

Sites Redirects

client.sites.redirects.list(siteId) -> Webflow.Redirects

📝 Description

Fetch a list of all URL redirect rules configured for a specific site.

Use this endpoint to review, audit, or manage the redirection rules that control how traffic is rerouted on your site.

This endpoint requires an Enterprise workspace.

Required scope: sites:read

🔌 Usage

await client.sites.redirects.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Redirects.RequestOptions

client.sites.redirects.create(siteId, { ...params }) -> Webflow.Redirect

📝 Description

Add a new URL redirection rule to a site.

This endpoint allows you to define a source path (fromUrl) and its corresponding destination path (toUrl), which will dictate how traffic is rerouted on your site. This is useful for managing site changes, restructuring URLs, or handling outdated links.

This endpoint requires an Enterprise workspace.

Required scope: sites:write

🔌 Usage

await client.sites.redirects.create("580e63e98c9a982ac9b8b741", {
    id: "42e1a2b7aa1a13f768a0042a",
    fromUrl: "/mostly-harmless",
    toUrl: "/earth",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.Redirect

requestOptions: Redirects.RequestOptions

client.sites.redirects.delete(siteId, redirectId) -> Webflow.Redirects

📝 Description

Remove a URL redirection rule from a site.

This is useful for cleaning up outdated or unnecessary redirects, ensuring that your site's routing behavior remains efficient and up-to-date.

This endpoint requires an Enterprise workspace.

Required scope: sites:write

🔌 Usage

await client.sites.redirects.delete("580e63e98c9a982ac9b8b741", "66c4cb9a20cac35ed19500e6");

⚙️ Parameters

siteId: string — Unique identifier for a Site

redirectId: string — Unique identifier site rediect

requestOptions: Redirects.RequestOptions

client.sites.redirects.update(siteId, redirectId, { ...params }) -> Webflow.Redirect

📝 Description

Update a URL redirection rule from a site.

This endpoint requires an Enterprise workspace.

Required scope: sites:write

🔌 Usage

await client.sites.redirects.update("580e63e98c9a982ac9b8b741", "66c4cb9a20cac35ed19500e6", {
    id: "42e1a2b7aa1a13f768a0042a",
    fromUrl: "/mostly-harmless",
    toUrl: "/earth",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

redirectId: string — Unique identifier site rediect

request: Webflow.Redirect

requestOptions: Redirects.RequestOptions

Sites Plans

client.sites.plans.getSitePlan(siteId) -> Webflow.SitePlan

📝 Description

Get site plan details for the specified Site.

This endpoint requires an Enterprise workspace.

Required scope | sites:read

🔌 Usage

await client.sites.plans.getSitePlan("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Plans.RequestOptions

Sites RobotsTxt

client.sites.robotsTxt.get(siteId) -> Webflow.Robots

📝 Description

Retrieve the robots.txt configuration for various user agents.

Required scope: site_config:read

🔌 Usage

await client.sites.robotsTxt.get("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: RobotsTxt.RequestOptions

client.sites.robotsTxt.put(siteId, { ...params }) -> Webflow.Robots

📝 Description

Replace the robots.txt configuration for various user agents.

Required scope | site_config:write

🔌 Usage

await client.sites.robotsTxt.put("580e63e98c9a982ac9b8b741", {
    rules: [
        {
            userAgent: "googlebot",
            allows: ["/public"],
            disallows: ["/vogon-poetry", "/total-perspective-vortex"],
        },
    ],
    sitemap: "https://heartofgold.ship/sitemap.xml",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.Robots

requestOptions: RobotsTxt.RequestOptions

client.sites.robotsTxt.delete(siteId, { ...params }) -> Webflow.Robots

📝 Description

Remove specific rules for a user-agent in your robots.txt file. To delete all rules for a user-agent, provide an empty rule set. This will remove the user-agent's entry entirely, leaving it subject to your site's default crawling behavior.

Note: Deleting a user-agent with no rules will make the user-agent's access unrestricted unless other directives apply.

Required scope: site_config:write

🔌 Usage

await client.sites.robotsTxt.delete("580e63e98c9a982ac9b8b741", {
    rules: [
        {
            userAgent: "*",
            allows: ["/public"],
            disallows: ["/bubbles"],
        },
    ],
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.Robots

requestOptions: RobotsTxt.RequestOptions

client.sites.robotsTxt.patch(siteId, { ...params }) -> Webflow.Robots

📝 Description

Update the robots.txt configuration for various user agents.

Required scope | site_config:write

🔌 Usage

await client.sites.robotsTxt.patch("580e63e98c9a982ac9b8b741", {
    rules: [
        {
            userAgent: "googlebot",
            allows: ["/public"],
            disallows: ["/vogon-poetry", "/total-perspective-vortex"],
        },
    ],
    sitemap: "https://heartofgold.ship/sitemap.xml",
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.Robots

requestOptions: RobotsTxt.RequestOptions

Sites ActivityLogs

client.sites.activityLogs.list(siteId, { ...params }) -> Webflow.SiteActivityLogResponse

📝 Description

Retrieve Activity Logs for a specific Site.

This endpoint requires an Enterprise workspace.

Required scope: site_activity:read

🔌 Usage

await client.sites.activityLogs.list("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.sites.ActivityLogsListRequest

requestOptions: ActivityLogs.RequestOptions

Sites Scripts

client.sites.scripts.getCustomCode(siteId) -> Webflow.ScriptApplyList

📝 Description

Get all scripts applied to a site by the App.

To apply a script to a site or page, the script must first be registered to a site via the [Register Script](/data/reference/custom-code/custom-code/register-hosted) endpoints. Once registered, the script can be applied to a Site or Page using the appropriate endpoints. See the documentation on [working with Custom Code](/data/docs/custom-code) for more information.

Required scope | custom_code:read

🔌 Usage

await client.sites.scripts.getCustomCode("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Scripts.RequestOptions

client.sites.scripts.upsertCustomCode(siteId, { ...params }) -> Webflow.ScriptApplyList

📝 Description

Apply registered scripts to a site.

To apply a script to a site or page, the script must first be registered to a site via the [Register Script](/data/reference/custom-code/custom-code/register-hosted) endpoints. Once registered, the script can be applied to a Site or Page using the appropriate endpoints. See the documentation on [working with Custom Code](/data/docs/custom-code) for more information.

Required scope | custom_code:write

🔌 Usage

await client.sites.scripts.upsertCustomCode("580e63e98c9a982ac9b8b741", {
    scripts: [
        {
            id: "cms_slider",
            location: "header",
            version: "1.0.0",
            attributes: {
                "my-attribute": "some-value",
            },
        },
        {
            id: "alert",
            location: "header",
            version: "0.0.1",
        },
    ],
});

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.ScriptApplyList

requestOptions: Scripts.RequestOptions

client.sites.scripts.deleteCustomCode(siteId) -> void

📝 Description

Remove scripts from a site applied by the App. This endpoint will not remove scripts from the site's registered scripts.

Required scope | custom_code:write

🔌 Usage

await client.sites.scripts.deleteCustomCode("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

requestOptions: Scripts.RequestOptions

client.sites.scripts.listCustomCodeBlocks(siteId, { ...params }) -> Webflow.ListCustomCodeBlocks

📝 Description

Get a list of scripts that have been applied to a site and/or individual pages.

To apply a script to a site or page, the script must first be registered to a site via the [Register Script](/data/reference/custom-code/custom-code/register-hosted) endpoints. Once registered, the script can be applied to a Site or Page using the appropriate endpoints.

See the documentation on working with Custom Code for more information.

Required scope | custom_code:read

🔌 Usage

await client.sites.scripts.listCustomCodeBlocks("580e63e98c9a982ac9b8b741");

⚙️ Parameters

siteId: string — Unique identifier for a Site

request: Webflow.sites.ScriptsListCustomCodeBlocksRequest

requestOptions: Scripts.RequestOptions

Files

reference.md

Latest commit

History

reference.md

File metadata and controls

Reference

Token

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

Sites

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

Collections

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

Pages

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

Components

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage

⚙️ Parameters

📝 Description

🔌 Usage