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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Create sheet

> Add a sheet with optional grid and display properties.

`createSheet` adds a tab to an existing spreadsheet.

## Example

```ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { createSheet } from "automate.ax/google-sheets"

export default automation("Add an archive sheet", () => {
  onHttpRequest({ scope: "automation" })

  createSheet({
    spreadsheet: "spreadsheet-id",
    title: "Archive",
    rowCount: 2000,
    columnCount: 20,
    frozenRowCount: 1,
  })
})
```

## Inputs

`spreadsheet` and unique `title` are required. Optional positive `rowCount` and
`columnCount`, nonnegative `frozenRowCount` and `frozenColumnCount`, zero-based
`index`, `hidden`, and `rightToLeft` set the initial sheet. `account` selects
the Google account.

## Output

Returns `Sheet` metadata with `sheetId`, title, zero-based index, grid counts,
frozen counts, visibility, direction, type, and an empty `tables` array.