Quickstart

npm install @usenaive-sdk/node

import { Naive, isPendingApproval } from "@usenaive-sdk/node";

const naive = new Naive({ apiKey: process.env.NAIVE_API_KEY! });

// Solo mode — every call auto-scopes to your default user.
await naive.vault.put("instantly.api_key", "key_xyz");

// `name` is required. The default provider (prepaid_gift) caps at $150; for a
// bigger ceiling pass provider: "managed_virtual", which needs a cardholder on
// file first (see /getting-started/cards).
await naive.cards.create({ name: "Ops", spending_limit_cents: 5000 });

// Sensitive calls can be parked for a human by the user's Account Kit, so the
// result is a union — narrow it before reading the redirect.
const res = await naive.connections.connect("gmail", {
  callbackUrl: "https://myapp.com/oauth/callback",
});
if (!isPendingApproval(res)) {
  console.log(res.redirectUrl);
}

// Multi-tenant — create a user, then scope with forUser(id).
const alice = await naive.users.create({
  external_id: "alice_db_uuid",
  email: "alice@example.com",
});

const client = naive.forUser(alice.id);
await client.cards.create({ name: "Ops", spending_limit_cents: 5000 });
await client.connections.connect("gmail", { callbackUrl });
const session = await client.session(); // per-user MCP session

// A project groups account kits and child projects (tenant users). Every
// organization has a default project, which is where the calls above land.
const staging = await naive.projects.create({ name: "Staging" });
const project = naive.forProject(staging.id);

const child = await project.childProjects.create({ external_id: "alice_db_uuid" });
await project.forChild(child.id).cards.create({ name: "Ops", spending_limit_cents: 5000 });