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

> Convenience: insert a line of text and apply HEADING_{level}.

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

## Call it

MCP tool call:

```json
{
  "name": "insert_doc_heading",
  "arguments": {
    "documentId": "<documentId>",
    "text": "<text>"
  }
}
```

Tool API (early access — contact us):

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

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `documentId` | string | yes | the Google Docs document ID. |
| `text` | string | yes | Heading text. A trailing newline is added automatically. |
| `level` | integer |  | 1..6. |
| `index` | integer |  | a body index at the start of a paragraph (from find_doc_text or get_doc). Omit to append — the heading then joins the last paragraph unless that paragraph is empty. |

## Result

- { insertedAt: int, endIndex: int }