Skip to main content
POST
Append rows after a Google Sheets table found in a bounded range; inserts rows, RAW by default

Authorizations

x-api-key
string
header
required

Organization API key passed as the x-api-key header. The raw key is the header value; do not prefix it with Bearer.

Path Parameters

spreadsheetId
string
required
Required string length: 1 - 512
Pattern: ^[A-Za-z0-9_-]+$

Body

application/json
range
string
required
Required string length: 1 - 256
values
((string | number | boolean)[])[]
required

Rows of literal strings, numbers, and booleans. Empty strings clear cells; missing trailing cells stay unchanged.

Required array length: 1 - 500 elements
Required array length: 1 - 100 elements
Maximum string length: 50000
valueInputOption
enum<string>
default:RAW

RAW stores strings literally, including =formulas. USER_ENTERED parses formulas/dates and can execute formulas or fetch external data; requires explicit approval via confirmUserEntered.

Available options:
RAW,
USER_ENTERED
confirmUserEntered
boolean

Response

Google-confirmed result.

ok
boolean
required
spreadsheetId
string
required
updatedRange
string
required
updatedRows
number
required
updatedColumns
number
required
updatedCells
number
required
tableRange
string
required
valueInputOption
enum<string>
default:RAW

RAW stores strings literally, including =formulas. USER_ENTERED parses formulas/dates and can execute formulas or fetch external data; requires explicit approval via confirmUserEntered.

Available options:
RAW,
USER_ENTERED