One customer view for all your Nuxt applications

Step 1 — Create a server utility for the SDK

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

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

Step 2 — Identify customers in a Nitro API route

// server/api/auth/signup.post.ts
import { tinycrm } from "~/server/utils/tinycrm";
import { useDB } from "~/server/utils/db";

export default defineEventHandler(async (event) => {
  const { email, name } = await readBody(event);
  const db = useDB();

  const user = await db.insert(users).values({ email, name }).returning();

  // TinyCRM identify — fire and forget
  tinycrm.identify({
    email: user[0].email,
    name: user[0].name,
    status: "free",
    params: { source: "web_signup" },
  });

  return { ok: true };
});

Step 3 — Track paid conversions from webhooks

// server/routes/webhooks/stripe.post.ts
import { tinycrm } from "~/server/utils/tinycrm";

export default defineEventHandler(async (event) => {
  const body = await readRawBody(event);
  const stripeEvent = await verifyStripeWebhook(body!, getHeader(event, "stripe-signature")!);

  if (stripeEvent.type === "customer.subscription.created") {
    const email = stripeEvent.data.object.metadata.email;
    tinycrm.identify({
      email,
      status: "paid",
      params: {
        plan: stripeEvent.data.object.metadata.plan,
        interval: stripeEvent.data.object.items.data[0].plan.interval,
      },
    });
  }

  return { received: true };
});

Step 4 — Use with Nuxt Auth Utils

// server/api/auth/github.get.ts
// Using nuxt-auth-utils (sidebase/nuxt-auth-utils)
import { tinycrm } from "~/server/utils/tinycrm";

export default oauthGitHubEventHandler({
  async onSuccess(event, { user }) {
    await setUserSession(event, { user });

    // Identify after OAuth sign-in
    tinycrm.identify({
      email: user.email,
      name: user.name,
      status: "free",
      params: { provider: "github" },
    });

    return sendRedirect(event, "/dashboard");
  },
});