Skip to main content

NocoDB

Overview​

The NocoDB source connector lets you connect to a NocoDB workspace using an API token.

Status​

This connector is currently in development:

  • Connection/auth validation is implemented.
  • Schema discovery (catalog) currently returns an empty catalog.
  • Data extraction is not yet implemented.

Prerequisites​

  • A NocoDB account/workspace
  • A NocoDB API token with access to the bases you want to sync

Authentication​

This connector authenticates using a NocoDB API token sent as the xc-token header.

Get an API token​

In NocoDB, generate or copy an API token for your user/workspace (location may vary by NocoDB version and deployment).

Setup​

  1. In your workspace, add a new Source and select NocoDB.
  2. Enter the required configuration fields (below).
  3. Save and test the connection.

Configuration reference​

FieldTypeRequiredDescription
api_tokenstring✅NocoDB API token. Used as the xc-token header for API requests.

Connectivity details​

  • The connector validates credentials by calling the NocoDB API endpoint: GET https://app.nocodb.com/api/v2/meta/bases
  • Network timeouts:
    • Connect timeout: 10 seconds
    • Request timeout: 30 seconds

Streams​

No streams are currently exposed because schema discovery and extraction are still in development.

Limitations​

  • Only NocoDB Cloud (https://app.nocodb.com) is currently used for credential validation.
  • Incremental sync, table selection, and record extraction are not yet available.