Skip to main content
POST
Create sheet

Authorizations

Authorization
string
header
required

API key prefixed with finta_

Body

application/json

Name alone creates one blank worksheet named Sheet 1. Names must be nonblank. template_id and custom worksheets are mutually exclusive. template_options requires template_id. No company selector or grid-size input is accepted. return_ranges selects calculated outputs after saving using worksheet-name-qualified A1 addresses, up to 100 selections and 10000 selected cells in total. Selections must fit the final grid and are validated before save. Omit return_ranges for metadata without calculation.

name
string
required
Required string length: 1 - 50
return_ranges
string[]

Optional selected results after saving. Invalid selections report error.param as return_ranges.

Maximum array length: 100

Response

Saved document with worksheet/chart IDs and optional calculated outputs.

Saved document metadata with an absolute configured-app URL and stable worksheet/chart IDs. POST always includes worksheets and their chart definitions; it does not emit operation_results. Use the returned revision rather than assuming a fixed initial value. Optional return_ranges adds calculated selections and status; calculation errors do not roll back the saved document. Revision tracks sheet edits, not freshness of underlying accounting data.

id
string
required
name
string
required
url
string
required
revision
integer
required
Required range: x >= 0
worksheets
object[]
ranges
object[]
calculation
object

Bounded synchronous calculation; no pending job is created. error means one or more formulas failed. unavailable means evaluation could not run; values are omitted rather than invented. Formula-error cells have null values and corresponding errors. A write can be saved even when this status is not complete.

operation_results
object[]