---
title: "Create a landing page folder"
method: POST
path: "/cms/pages/2026-09/landing-pages/folders"
tags: ["Folders"]
---

# Create a landing page folder

`POST /cms/pages/2026-09/landing-pages/folders`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/cms/pages/2026-09/landing-pages/folders`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `content`

Create a new folder for landing pages.

## Request body `*/*`

- ContentFolder
  - `category` integer, required: The type of object this folder applies to. Should always be LANDING_PAGE.
  - `created` string, date-time, required: The timestamp indicating when the content folder was created.
  - `deletedAt` string, date-time, required: The timestamp (ISO8601 format) when this content folder was deleted.
  - `id` string, required: The unique ID of the content folder.
  - `name` string, required: The name of the folder which will show up in the app dashboard
  - `parentFolderId` integer, required: The ID of the content folder this folder is nested under
  - `updated` string, date-time, required: The timestamp indicating when the content folder was last updated.

## Response `201`

successful operation

- ContentFolder
  - `category` integer, required: The type of object this folder applies to. Should always be LANDING_PAGE.
  - `created` string, date-time, required: The timestamp indicating when the content folder was created.
  - `deletedAt` string, date-time, required: The timestamp (ISO8601 format) when this content folder was deleted.
  - `id` string, required: The unique ID of the content folder.
  - `name` string, required: The name of the folder which will show up in the app dashboard
  - `parentFolderId` integer, required: The ID of the content folder this folder is nested under
  - `updated` string, date-time, required: The timestamp indicating when the content folder was last updated.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-10** (2026-09) `6da012f8648e`: 2 info
  - the security scope `content` was added to the endpoint's security scheme `oauth2`
  - the security scope `content.landing_pages.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-09** (2026-09) `16635021c7ea`: 2 info
  - the security scope `content.landing_pages.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `content` was removed from the endpoint's security scheme `oauth2`
- **2026-09-09** (2026-09) `9304e64d8fee`: 2 info
  - the security scope `content.landing_pages.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `content` was removed from the endpoint's security scheme `oauth2`
- **2026-09-03** (2026-09) `802b97d357a4`: 2 info
  - the security scope `content.landing_pages.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `content` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/cms-pages/changes/cms/pages/2026-09/landing-pages/folders/post.md)

---

[API](https://skmtc.dev/hubspot/apis/cms-pages.md) - [All operations](https://skmtc.dev/hubspot/apis/cms-pages/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/cms-pages/revisions/2d6b40da6e33?raw)