Docs integration | Flomation Support

00Overview

Google Docs document operations

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting Docs

Docs signs in with a Google account you connect to Flomation — there is no API key or secret to paste. Connect the account once and every Docs node picks it up automatically. Two optional fields let you steer it:

Field	Type		Details
Google Account (email)	`string`
Google OAuth Credential	`credential`		${credentials.GOOGLE_DRIVE}

Good to know

Connect the Google account to your Flomation user once — the same grant covers every Google node, so you do not repeat it per flow. The optional Google OAuth Credential field never shows a token: it references a managed credential (e.g. ${credentials.GOOGLE_DRIVE}), not an environment secret. Leave both fields blank and the node just uses your connected account.

02Append

Append to Document

google/docs/append_text · Action

Append text to the end of a Google Docs document

Field	Type		Details
Document ID	`string`	Required
Text to Append	`text`	Required

Returns: tool_result, success, error

03Create

Create Document

google/docs/create · Action

Create a new Google Docs document

Field	Type		Details
Title	`string`	Required	My Document
Initial Content	`text`

Returns: tool_result, document_id, document_url, success, error

04Fill

Fill Document Table

google/docs/fill_table · Action

Write values into the cells of a table in a Google Doc (by row and column)

Field	Type
Document ID	`string`	Required
Which table (0-based, in document order)	`integer`
Cells to fill: JSON array of {"row":N,"column":N,"text":"..."} (0-based)	`text`	Required
Clear each cell's current text before writing	`boolean`

Returns: tool_result, cells_written, success, error

05Get

Get Document Metadata

google/docs/get_metadata · Action

Get metadata for a Google Docs document

Field	Type		Details
Document ID	`string`	Required

Returns: tool_result, title, revision_id, document, success, error

06Import

Convert to Google Doc

google/docs/import_doc · Action

Convert a Drive file (e.g. an uploaded .docx) into a native, editable Google Doc

Field	Type
Source Drive File ID (.docx, .odt, etc.)	`string`	Required
Name for the new Google Doc (defaults to the source name)	`string`
Destination Folder ID (defaults to the source's location)	`string`

Returns: tool_result, document_id, web_link, already_native, success, error

07Insert

Insert Image in Document

google/docs/insert_image · Action

Insert an image into a Google Docs document

Field	Type		Details
Document ID	`string`	Required
Image URL	`string`	Required
Width (points)	`integer`		400
Height (points)	`integer`		300

Returns: tool_result, success, error

08Read

Read Document

google/docs/read · Action

Read the content of a Google Docs document

Field	Type		Details
Document ID	`string`	Required

Returns: tool_result, content, tables, title, document, success, error

09Replace

Replace Text in Document

google/docs/replace_text · Action

Find and replace text in a Google Docs document

Field	Type
Document ID	`string`	Required
Find Text	`string`	Required
Replace With	`string`	Required
Match Case	`boolean`

Returns: tool_result, occurrences_replaced, success, error

10Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

The Google connection here is shared with Google Drive, so a single OAuth credential (GOOGLE_DRIVE) authorises every Docs action and one authorisation covers both.
Every action identifies a document by its Document ID — the identifier string taken from the document's URL — not the full shareable link you copy from the browser.
Replace Text acts across the whole document and swaps every matching occurrence at once, so prefer distinctive placeholder tokens (for example {{customer_name}}) to avoid unintended matches.
Replace Text ignores letter case unless Match Case is enabled, meaning "Draft" and "draft" are both replaced by default.
Insert Image needs a publicly reachable image URL that Google can fetch directly — links behind a login or private permissions will fail — and accepts only PNG, JPEG, or GIF files.
Read Document returns the document's body text only; embedded images, and content in headers or footers, are not included in the extracted text.