Coda integration overview

Overview

Coda is an all-in-one document platform that combines documents, spreadsheets, databases, and lightweight applications into collaborative workspaces. Persona’s integration with Coda helps teams sync operational data between Persona workflows and Coda docs or tables.

This integration reduces manual updates by allowing teams to retrieve document metadata, manage tables, and create or update rows directly from Persona workflows. It is especially useful for teams using Coda to manage investigations, operational tracking, reviews, or internal workflows.

Benefits

Automated Operational Tracking: Automatically create or update Coda table rows based on Persona events such as verification failures, fraud alerts, escalations, or manual reviews.

Centralized Collaboration:Keep investigation tracking, operational workflows, and review notes organized in collaborative Coda docs.

Improved Workflow Efficiency: Reduce manual data entry and sync operational data directly between Persona and Coda workflows.

Integration Features

Persona’s Coda integration supports workflow automation across docs, tables, and rows. Key capabilities include:

  • Retrieve doc metadata: Access document information including ownership, workspace, publishing status, and usage metrics.
  • Manage tables: List and retrieve tables or views within a Coda doc.
  • Insert and update rows: Create, update, or upsert rows in Coda tables directly from Persona workflows.
  • Support for structured workflows: Sync operational data into collaborative Coda tables and workflows.

Setting up the Coda integration

Prerequisites

To set up the Coda integration, ensure you have:

  • Access to a Coda workspace and doc.
  • Permission to generate Coda API tokens.
  • Access to the docs and tables you want Persona to use.

Setting up the Coda credentials

  1. In the Persona Dashboard, navigate to Integrations > Marketplace and click Coda.
  2. Click Add Credential at the top of the page.
  3. Enter a credential nickname and click Continue.
  4. Generate or provide a Coda API token from your Coda account settings.
  5. Complete the credential setup flow.

Using the Coda integration in a workflow

  1. Create a new workflow, or open an existing workflow you’d like to update.
  2. Add a new Action Step > Integrations.
  3. Select the Coda integration and choose your Coda credentials.
  4. Configure the required input fields, such as Doc ID, Table ID, Row ID, or row values.
  5. Save and publish the workflow.

Coda Operations Overview

Persona can take direct actions on Coda docs and tables using Coda’s API. These actions help teams manage operational workflows, investigation tracking, and collaborative review processes without leaving Persona.

Get Doc Workflow Action Step

Retrieves metadata about a Coda doc.

Configuration Steps:

Provide values for required fields:

  • Doc ID

List Tables Workflow Action Step

Retrieves tables and views within a Coda doc.

Configuration Steps:

Provide values for required fields:

  • Doc ID

Optionally configure:

  • Pagination settings
  • Sort order
  • Table type filters

Get Table Workflow Action Step

Retrieves metadata for a specific Coda table or view.

Configuration Steps:

Provide values for required fields:

  • Doc ID
  • Table ID or Name

Insert or Upsert Rows Workflow Action Step

Creates new rows or updates existing rows in a Coda table.

Configuration Steps:

Provide values for required fields:

  • Doc ID
  • Table ID or Name
  • Row cell values

Optionally configure:

  • Key columns for upsert behavior
  • Parsing preferences

Note: Row writes are processed asynchronously by Coda.

Get Row Workflow Action Step

Retrieves a single row from a Coda table.

Configuration Steps:

Provide values for required fields:

  • Doc ID
  • Table ID or Name
  • Row ID or Name

Optionally configure:

  • Column naming preferences
  • Value formatting

Update Row Workflow Action Step

Updates specific cells on an existing row in a Coda table.

Configuration Steps:

Provide values for required fields:

  • Doc ID
  • Table ID or Name
  • Row ID or Name
  • Updated cell values

Optionally configure:

  • Parsing preferences

Note: Row updates are processed asynchronously by Coda.

FAQs

Can I retrieve rows using display values instead of row IDs?

Yes. Rows can be retrieved or updated using either row IDs or display column values.

Are row writes processed immediately?

No. Coda processes row insertions and updates asynchronously. Returned request IDs can be used to confirm completion.