# Create a document folder

> The create_document_folder MCP tool: create a document folder.

`create_document_folder` · writes

[REST: `POST /v1/trips/{tripId}/document-folders`](https://api.bymundi.com/docs/reference/documents.folders.create.md)

## What the model reads

Creates a folder in a trip's documents — how travelers see their released documents grouped (e.g. 'Flights', 'Hotels', 'Insurance'). File documents into it with update_document. undo_change removes it while it is still empty.

Permissions: documents:write.
Undo: the result names a change id; undo_change reverts it.

## Input

| Field | Type | Required | Description |
|---|---|---|---|
| `tripId` | uuid | yes |  |
| `name` | string | yes | As travelers will see it, e.g. 'Flights', 'Hotels', 'Insurance'. max 200 chars |

## Input schema (JSON)

```json
{
  "type": "object",
  "properties": {
    "tripId": {
      "type": "string",
      "format": "uuid"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "As travelers will see it, e.g. 'Flights', 'Hotels', 'Insurance'."
    }
  },
  "required": [
    "tripId",
    "name"
  ],
  "additionalProperties": false
}
```