> ## 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 Item

> Add an item to a custom CV section

## Overview

Add an entry to a custom section. Only fields enabled in the section definition are persisted - other fields are silently dropped.

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

## Request

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

### Path Parameters

<ParamField path="id" type="string" required>
  Section definition id
</ParamField>

### Body Parameters

All fields are optional. Use only those listed in the parent section's `enabledFields`.

<ParamField body="title" type="string">
  Item title (max 200 characters)
</ParamField>

<ParamField body="subtitle" type="string">
  Item subtitle (max 200 characters)
</ParamField>

<ParamField body="organization" type="string">
  Organisation (max 200 characters)
</ParamField>

<ParamField body="location" type="string">
  Location (max 200 characters)
</ParamField>

<ParamField body="description" type="string">
  Free-text description
</ParamField>

<ParamField body="startDate" type="string">
  Free-text date or YYYY-MM-DD (max 20 characters)
</ParamField>

<ParamField body="endDate" type="string">
  Free-text date or YYYY-MM-DD (max 20 characters)
</ParamField>

<ParamField body="url" type="string">
  URL (max 500 characters)
</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": "cli..."
}
```