> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mokaru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Custom Section

> Create a new user-defined CV section

## Overview

Create a new custom section definition. After creation, add items via `POST /v1/custom-sections/:id/items`.

<Note>
  **Scope required:** `custom-sections:write` | **Rate limit:** 20 requests/min
</Note>

## Request

```bash theme={null}
POST /v1/custom-sections
Content-Type: application/json
```

### Body Parameters

<ParamField body="sectionTitle" type="string" required>
  Section title shown in the CV (e.g. "Volunteer Work")
</ParamField>

<ParamField body="enabledFields" type="string[]" required>
  Which fields items can use. At least one required. Allowed values: `"title"`, `"subtitle"`, `"organization"`, `"location"`, `"description"`, `"startDate"`, `"endDate"`, `"url"`
</ParamField>

<ParamField body="icon" type="string" default="star">
  Lucide icon name shown next to the section
</ParamField>

### Query Parameters

<ParamField query="cvId" type="string">
  Target a specific resume by its id (from `list-resumes`). Omit to use your base/default resume; the resume must be self-contained.
</ParamField>

## Response

```json theme={null}
{
  "success": true,
  "id": "clx..."
}
```