create_google_spreadsheet

Create an empty Google spreadsheet and register its linked data source.

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
model_name	Annotated[str, Field(description='Name of the Bridge Town model.')]	Yes	—
source_name	Annotated[str, Field(description='New linked data-source name for the spreadsheet.')]	Yes	—
title	Annotated[str, Field(description='Title for the new Google spreadsheet.')]	Yes	—
initial_tabs	`Annotated[list[Annotated[str, Field(min_length=1, max_length=100)]]	None, Field(max_length=25, description=‘Optional bounded tab names to create in the new spreadsheet.’)]`	No	None
workspace_id	`Annotated[str	None, Field(description=WORKSPACE_ID_FIELD_DESCRIPTION)]`	No	None

Returns

Returns a structured object. Top-level fields:

• created (boolean)
• source_name (string)
• spreadsheet_id (string)
• rows_written (integer)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "create_google_spreadsheet",
  "arguments": {
    "model_name": "forecasts",
    "source_name": "forecast_board",
    "title": "FY26 Forecast",
    "initial_tabs": [
      "Forecast",
      "Notes"
    ]
  }
}

Response

{
  "created": true,
  "source_name": "forecast_board",
  "spreadsheet_id": "1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789ABCDEFG",
  "rows_written": 0
}

Notes

• Module: Google Sheets
• Requires authentication via API token or Auth0 JWT.