Coda | Sim Docs

Coda (now Superhuman Docs) combines documents, tables, and automations in one doc. The Coda block lets your agents read and write that doc: create and publish docs, write pages in Markdown or HTML, read and update table rows, push row buttons, read formulas and controls, trigger automations, and manage sharing, folders, and analytics.

Authentication

This integration uses a reusable Coda API token connection, not OAuth. In Coda, open Account settings → API settings and generate a token. A token can be unrestricted, or limited to specific docs or tables with read or read-and-write access; a restricted token can only reach what it was granted. Create a Coda connection from the block's Coda Account field. Sim checks the token once against Coda, stores it encrypted, and reuses the same connection across Coda blocks. You can replace or revoke it from credential settings.

Working with Coda data

Pickers: After you pick an account, the Doc, Page, Table, Row, Column, Formula, Control, Folder, and Permission fields list what that token can reach. Switch a field to advanced mode to enter an ID, or pass one from an earlier block. IDs are safer than names, because users can rename things in the doc.
Links to IDs: Resolve Browser Link turns a Coda URL someone pasted into the resource type and ID the other operations need.
Changes apply in the background: Row, page, publishing, and automation writes return a requestId right away and are applied a few seconds later. Check that a change finished with Get Mutation Status. Data you read can also lag a few seconds behind edits made in the browser.
Rows: Pass rows as objects that map column IDs or names to values, for example [{"Name": "Apple", "Price": 1.25}]. Set Upsert Key Columns to update matching rows instead of adding duplicates. Inserts only work on base tables, not views. Turn on Use Column Names when reading rows to get values keyed by column name.
Incremental reads: List Rows returns a nextSyncToken. Pass it back later as Sync Token to get only rows that changed since then.
Pagination: List operations return a nextPageToken. Pass it as Page Token to get the next page. When a Page Token is set, the original filters and limit are reused automatically. Coda can change page sizes at any time, so keep paging until no token comes back.
Page content: Get Page Content reads a page as plain-text lines, with element IDs you can target in Update Page or Delete Page Content. To delete content, enter element IDs, or turn on Delete All Page Content to clear the whole page. For the full page as Markdown or HTML, run Export Page, then call Get Page Export Status until downloadLink is present. The link expires shortly after it is issued.
Permissions and plans: Creating docs and pages or renaming a doc requires Doc Maker access in the workspace. Publishing needs a Coda maker profile. Hiding pages and custom domains need a paid Coda plan. Workspace members, role activity, and role changes need a workspace that belongs to an organization, and role changes need Admin access. Page analytics are only available for docs in Enterprise workspaces.
Rate limits: Coda limits requests per user, with tighter limits on writes and on listing docs. Sim automatically retries reads, updates, and deletes when Coda returns HTTP 429 or a transient server error. Inserts and creates are not retried, so space out bulk writes.

Usage Instructions

Integrate Coda (Superhuman Docs) into your workflow with a reusable API-token credential. Create, copy, publish, and share docs; create, update, read, export, and clear pages; read table schemas; list, insert, upsert, update, and delete rows and push row buttons; read formulas and controls; trigger webhook automations; manage folders, custom domains, and workspace roles; and read doc and page analytics. Pick docs, pages, tables, rows, and more from dropdowns populated by your account.

Actions

Coda Add Custom Domain

Connect a custom domain to a published Coda doc. Requires a Coda plan with custom domains.

Parameter	Type	Required	Description
`docId`	string	Yes	ID of the doc (e.g., "AbCDeFGH")
`customDocDomain`	string	Yes	The custom domain (e.g., "docs.example.com")

Parameter	Type	Description
`docId`	string	ID of the doc
`customDocDomain`	string	The custom domain that was added

Parameter	Type	Required	Description
`docId`	string	Yes	ID of the doc (e.g., "AbCDeFGH")
`access`	string	Yes	Access level to grant: "readonly", "comment", or "write"
`principalType`	string	Yes	Who to share with: "email", "group", "domain", "workspace", or "anyone"
`principal`	string	No	Email address, group ID, domain, or workspace ID matching principalType. Not used for "anyone".
`suppressEmail`	boolean	No	Do not send a sharing notification email

Parameter	Type	Description
`docId`	string	ID of the shared doc
`access`	string	Access level granted
`principalType`	string	Type of principal the doc was shared with