Customer tracking for React apps — without client-side scripts

Step 1 — Initialize the SDK on your Express server

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

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

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

// server/routes/auth.ts
import express from "express";
import { tinycrm } from "../lib/tinycrm";
import { db } from "../lib/db";

const router = express.Router();

router.post("/signup", async (req, res) => {
  const { email, name, password } = req.body;

  const user = await db.users.create({ email, name, password });

  // Fire-and-forget — won't delay the response
  tinycrm.identify({
    email: user.email,
    name: user.name,
    status: "free",
    params: { signup_source: req.headers.referer ?? "direct" },
  });

  res.json({ ok: true, userId: user.id });
});

export default router;

Step 3 — Track paid conversions

// server/routes/webhooks.ts
router.post("/webhooks/payment", async (req, res) => {
  const { email, plan } = verifyPaymentWebhook(req);

  tinycrm.identify({
    email,
    status: "paid",
    params: { plan },
  });

  res.sendStatus(200);
});

Step 4 — Use with React Query for real-time UI updates

// components/SignupForm.tsx — React component (client side)
// This calls YOUR backend, not TinyCRM directly
import { useMutation } from "@tanstack/react-query";

function SignupForm() {
  const signup = useMutation({
    mutationFn: async (data: { email: string; name: string }) => {
      const res = await fetch("/api/auth/signup", {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify(data),
      });
      return res.json();
    },
  });

  return (
    <form onSubmit={(e) => {
      e.preventDefault();
      signup.mutate({ email: "...", name: "..." });
    }}>
      {/* form fields */}
    </form>
  );
}

Step 5 — Serverless function variant (AWS Lambda)

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

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

export const handler = async (event: AWSEvent) => {
  const { email, name } = JSON.parse(event.body!);

  // ... create user in DB ...

  // TinyCRM identify — fire and forget
  tinycrm.identify({ email, name, status: "free" });

  return { statusCode: 200, body: JSON.stringify({ ok: true }) };
};