# insert_doc_table (https://sellersheetai.com/docs/mcp-api/tools/insert_doc_table)

> Insert an empty table.

Access: **WRITE** · toolset google_workspace · family null

Fill cells with set_doc_table_cell_text (tableIndex counts tables in document order), or create and fill a table in one call with write_doc_structured's table block.

## Call it

MCP tool call:

```json
{
  "name": "insert_doc_table",
  "arguments": {
    "documentId": "<documentId>",
    "rows": 1,
    "columns": 1
  }
}
```

Tool API (early access — contact us):

```bash
curl -X POST https://api.sellersheetai.com/api/v1/tools/insert_doc_table \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"documentId":"<documentId>","rows":1,"columns":1}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `documentId` | string | yes | the Google Docs document ID. |
| `rows` | integer | yes | Number of rows (>=1). |
| `columns` | integer | yes | Number of columns (>=1). |
| `index` | integer |  | Insertion index. Omit to append. |

## Result

- { inserted: true }