The customer database your Next.js app is missing

Step 1 — Create a project and get your API key

Sign up at app.tinycrm.dev, create a project for your Next.js app, and copy the API key.

Step 2 — Add the key to your environment

# .env.local
TINYCRM_API_KEY=tcrm_proj_xxxxxxxxxxxx

Step 3 — Create a shared SDK instance

// lib/tinycrm.ts
import { TinyCRM } from "tinycrm-sdk";

export const tinycrm = new TinyCRM({
  apiKey: process.env.TINYCRM_API_KEY!,
});

Step 4 — Call identify() in your sign-up route

// app/api/auth/signup/route.ts
import { NextResponse } from "next/server";
import { tinycrm } from "@/lib/tinycrm";
import { prisma } from "@/lib/prisma";

export async function POST(req: Request) {
  const { email, name } = await req.json();

  // Create user in your own database
  const user = await prisma.user.create({
    data: { email, name },
  });

  // Sync to TinyCRM (fire-and-forget — doesn't block response)
  tinycrm.identify({
    email: user.email,
    name: user.name,
    status: "free",
    params: { source: "signup_form" },
  });

  return NextResponse.json({ ok: true });
}

Step 5 — Track upgrades and plan changes

// app/api/webhooks/stripe/route.ts
import { tinycrm } from "@/lib/tinycrm";

export async function POST(req: Request) {
  const event = await verifyStripeWebhook(req);

  if (event.type === "checkout.session.completed") {
    const email = event.data.object.customer_email!;

    tinycrm.identify({
      email,
      status: "paid",
      params: {
        plan: event.data.object.metadata.plan,
        stripe_customer_id: event.data.object.customer as string,
      },
    });
  }

  return new Response("ok");
}

Step 6 — Ping on meaningful activity

// Anywhere in your API routes
import { tinycrm } from "@/lib/tinycrm";

// Update last_activity timestamp without changing status/params
tinycrm.ping({ email: session.user.email });