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

# spreadsheets_create

> Create a new spreadsheet.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://sheets.googleapis.com/v4/spreadsheets"}</code></div>

```python gsheets_spreadsheets_create.py theme={null}
from charter.packs import gsheets

result = await gsheets.spreadsheets_create.ainvoke({})
```

<Note>
  Requires `https://www.googleapis.com/auth/spreadsheets`. Costs 1 against the provider's own quota.
</Note>

<Warning>
  This tool's JSON schema is 135 KB, because it models the whole resource this endpoint writes.
  That is more context than most tasks. Narrow it at the call site
  with [`Tool.derived`](/charter/charter/reference/tool#tool-derived):

  ```python theme={null}
  narrowed = gsheets.spreadsheets_create.derived(
      name="spreadsheets_create_narrowed",
      drop={"spreadsheet.sheets", "spreadsheet.properties", "spreadsheet.data_sources"},
  )
  ```

  Those are its heaviest branches by schema size, not a recommendation: which ones you can spare is yours to decide. The tool underneath is unchanged.
  See [Projections](/charter/charter/tools/projections).
</Warning>

## Body

<div className="reference-table">
  | Field         | Type                                                                   | Description                                                                                                                                                                                             |
  | ------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `spreadsheet` | [Spreadsheet](/charter/charter/packs/gsheets/spreadsheets/objects#spreadsheet) | The spreadsheet to create. Contains properties (e.g., title), sheets, named ranges, and so on. Only the title and sheet structure are typically honoured on create; the spreadsheet is otherwise empty. |
</div>