Knack plugin

• Where the pair comes from. An account Owner copies both from the Builder under Settings > API (Next-Gen apps: Settings > API & Code > API). The same page shows the plan’s daily call limit.
• Field names, not labels. Knack stores each column as field_1, field_2, and so on. applications.get and objects.get return each field’s key beside its name, so read those first to learn which field_N to send.
• Read-only mirrors. Every value comes back twice: field_23 is the display string and field_23_raw is the typed form. Only the plain field_N is writable; the plugin rejects a _raw or _html key in a write rather than sending it.
• A missing record is not a 404. Knack answers 200 with an empty records list for an id that does not exist, and 200 with {} for an object key that is not in the app. records.get and objects.get raise on those answers, so a missing record cannot look like one with no fields.
• Filters need their index. Knack reads filters[0][field], filters[0][operator] and filters[0][value]. The unindexed form is silently ignored and returns every record, so the plugin builds the indexed names itself.
• Rate limits. 10 requests a second for every plan, answered as a 429 whose body is the plain text Rate limit exceeded. A short window is retried; a 429 that says Plan Limit Exceeded, or a reset more than a minute away, is the daily plan allowance and fails immediately.
• HIPAA apps are not supported. The plugin calls api.knack.com. Apps moved to Knack’s HIPAA environment before July 1, 2026 must use usgc-api.knack.com, so their requests are rejected.
• Records only, not app structure. The plugin reads tables and fields, and writes records. Creating tables or fields is not part of the REST API.
• Webhooks. The plugin does not receive webhooks; Knack exposes no subscription call.

• 8 typed API operations

​

Setup

npm install corsair @corsair-dev/knack better-sqlite3
npm install --save-dev @types/better-sqlite3

yarn add corsair @corsair-dev/knack better-sqlite3
yarn add --dev @types/better-sqlite3

pnpm install corsair @corsair-dev/knack better-sqlite3
pnpm install --save-dev @types/better-sqlite3

bun add corsair @corsair-dev/knack better-sqlite3
bun add --dev @types/better-sqlite3

import Database from 'better-sqlite3';
import { createCorsair } from 'corsair';
import { knack } from '@corsair-dev/knack';

export const corsair = createCorsair({
	plugins: [
		knack(),
	],
	database: new Database('corsair.db'),
	kek: process.env.CORSAIR_KEK!,
	multiTenancy: true,
	hub: {
		projectApiKey: process.env.CORSAIR_API_KEY!,
		signingSecret: process.env.CORSAIR_SIGNING_SECRET!,
	},
});

knack()

const { connectUrl } = await corsair.manage.connect.createLink({
	plugin: 'knack',
	tenantId: 'acme',
});
// redirect the user's browser to connectUrl

​

Example API calls

const tenant = corsair.withTenant('acme');
await tenant.knack.api.objects.list({});

const tenant = corsair.withTenant('acme');
await tenant.knack.api.records.create({
	object_key: 'object_3',
	fields: { field_23: 'Acme Logistics' },
});

​

What’s next