---
title: "Create a section"
method: POST
path: "/brandfolders/{brandfolder_id}/sections"
tags: ["sections"]
---

# Create a section

`POST /brandfolders/{brandfolder_id}/sections`

Creates a section in the matching Brandfolder.

## Request body

- object
  - `data` object, required
    - `attributes` object, required
      - `name` string, required — A name.
      - `default_asset_type` 'GenericFile' | 'Color' | 'Font' | 'ExternalMedium' | 'Person' | 'Press' | 'Text', required — Set this to the type of asset to put in the section. IMPORTANT: If you're using the API to add assets to the section, we strongly recommend setting this to `GenericFile`.
      - `position` integer — Set this to a non-negative integer that represents where to display the section relative to other sections. The first position is `0`. The new position defaults to the next available position.

## Response `200`

The new section.

- object
  - `data` Section, required
    - `id` string, required — Unique identifier for the resource instance.
    - `type` 'sections', required — The type of the resource.
    - `attributes` SectionAttributes, required
      - `name` string — The name of the section.
      - `default_asset_type` 'GenericFile' | 'Color' | 'Font' | 'ExternalMedium' | 'Person' | 'Press' | 'Text' — The type of asset the section contains.
      - `position` integer — A non-negative integer that represents where the section displays relative to other sections. The first position is `0`.

## Other responses

- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/brandfolder-openapi-reference/revisions/fd95b0a2d2f8/schema)