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

# AddChapter

> Add a chapter to a project via MCP

## Overview

Adds a new chapter to an existing video project. Chapters are segments of your video with individual content and duration.

## Parameters

<ParamField path="project_id" type="string" required>
  The project ID (e.g., `prj_abc123xyz`)
</ParamField>

<ParamField path="name" type="string" required>
  Chapter name (1-30 characters)
</ParamField>

<ParamField path="duration" type="number">
  Optional duration in seconds (must be positive integer)
</ParamField>

## Returns

Returns the created chapter with its unique ID.

## Example Usage

### In Claude

```
Add a 30-second intro chapter to project prj_abc123xyz
```

```
Create chapters for my video: Intro (15s), Main Content (60s), Outro (10s)
```

### Direct Tool Call

```json theme={null}
{
  "name": "AddChapter",
  "arguments": {
    "project_id": "prj_abc123xyz",
    "name": "Introduction",
    "duration": 30
  }
}
```

### Response

```json theme={null}
{
  "id": "cht_def456uvw",
  "project_id": "prj_abc123xyz",
  "name": "Introduction",
  "duration": 30,
  "created_at": "2025-12-02T10:01:00Z"
}
```

## Common Use Cases

<AccordionGroup>
  <Accordion title="Single chapter" icon="file">
    ```
    Add a chapter called "Tutorial" to my project
    ```
  </Accordion>

  <Accordion title="Multiple chapters" icon="files">
    ```
    Create these chapters: Introduction, Features, Pricing, Call to Action
    ```
  </Accordion>

  <Accordion title="Timed chapters" icon="clock">
    ```
    Add a 45-second chapter called "Product Demo"
    ```
  </Accordion>
</AccordionGroup>

## Next Steps

After adding chapters:

* Use [AddPrompt](/mcp/tools/add-prompt) to fill chapters with content
* Use [ListChapters](/mcp/tools/list-chapters) to view all chapters in the project

## REST API Equivalent

This tool calls: `POST /api/v1/projects/{projectId}/chapters`

See the [Create Chapter API documentation](/api-reference/chapters/create) for more details.