Data Connectors

Connect Airtable, Google Sheets, Notion, and REST APIs as live data sources for your generated apps and workflows, no manual API wiring.

What They Are

Data Connectors plug your generated app into external data sources without writing API integration code. Configure once, then read and write through a uniform SDK at window.genmb.connector or via the matching workflow nodes.

Uniform read/write API across very different upstream services.
Credentials encrypted at rest and decrypted only at call time.
Same connector usable from generated app code and from workflow nodes.
Schema introspection so the AI can suggest field names accurately.

Available Connectors

Airtable

Connect a base by personal access token. Read and write records, list tables, and filter by formula.

Google Sheets

Connect via Google OAuth. Read ranges, append rows, and write cells across multiple worksheets in the same spreadsheet.

Notion

Connect with an integration token. Query databases by filter, page through large result sets, create and update pages.

REST API

Generic connector for any HTTPS API. Configure base URL, headers, and auth. Use when there is no native connector for your provider.

Setup

Open the Connectors panel

From your app editor sidebar, open the Connectors panel. Click Add Connector and pick the source type (Airtable, Google Sheets, Notion, or REST API).

Authenticate

For Google Sheets, complete the OAuth flow. For Airtable and Notion, paste the personal access or integration token. For REST APIs, configure base URL and any required headers.

Pick the data scope

Select the specific base, spreadsheet, or database you want this connector to expose. This scoping is what keeps a connector locked to its intended source.

Reference it in code or workflows

The connector is now available to your generated app via window.genmb.connector and to workflow nodes by name.

Using Connectors in Apps

When a connector is configured, the AI knows about its schema and can generate code that reads from it directly. You can also call the SDK manually:

// Read records from a configured Airtable connector const { records } = await window.genmb.connector.airtable.list({ table: 'Tasks', filter: '{Status} = "Open"', }) // Append a row to Google Sheets await window.genmb.connector.sheets.append({ worksheet: 'Leads', values: ['Ada', 'ada@example.com', new Date().toISOString()], })

Using Connectors in Workflows

Workflow nodes for Google Sheets, Airtable, and Notion route through the same connector layer. Pick the connector by name in the node config; data flows through with the standard {{node_id.field}} interpolation.

Configure the connector at the app level and reference it from multiple workflows. You don't need a separate connector per workflow - credentials are shared at the app scope.

Security

Fernet encryption

All connector tokens are encrypted at rest with Fernet. The encryption key never ships to the browser.

Per-app scope

Connectors live on a single app. There is no cross-app sharing - moving an app between owners revokes its connectors.

Outbound only

Connectors initiate calls to the upstream service. Nothing accepts inbound traffic; webhooks must use Workflow webhook triggers.

SSRF protection

REST API connectors are validated against private IP ranges and require HTTPS - internal networks cannot be probed via a configured connector.

For more on how workflow nodes use connectors and what limits apply at the workflow layer, see Automation Workflows.

FAQs

How is a Data Connector different from a Plugin?▾

Plugins inject UI and SDK code (Stripe checkout, Clerk auth widgets) into the frontend. Data Connectors are read-and-write data sources, your app queries them via the connector SDK as if they were a database, regardless of whether the data lives in Airtable, a Google Sheet, Notion, or a REST API.

Where are credentials stored?▾

Connector credentials (API tokens, OAuth refresh tokens) are encrypted at rest using Fernet and only decrypted at the moment an outbound call is made. They are scoped per app - a connector configured for one app is not available to another.

Can I use Data Connectors in workflows?▾

Yes. Workflow nodes for Google Sheets, Airtable, and Notion read directly through the same connector layer. Configure the connector once and reference it from any workflow node or generated app code.

Are there rate limits?▾

GenMB respects the upstream provider's rate limits and surfaces 429 errors back to your app. Cache reads on your side if you expect high traffic, the connector layer does not cache automatically.

Ready to build?

Create your first app for free, no credit card required.

Vector DB & RAG Scheduled Agents