Documentación

curl -X POST https://howmanyusers.wtf/api/v1/events \
  -H "Authorization: Bearer $HMU_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event":"user.created","user_id":"usr_123","created_at":"2026-08-08T20:00:00Z"}'

// HowManyUsers — desde tu servidor (Node, Next.js, cualquier backend).
// La clave secreta vive en el entorno. NUNCA en el código del navegador.
async function hmuUserCreated(user) {
  const res = await fetch("https://howmanyusers.wtf/api/v1/events", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.HMU_SECRET_KEY}`,
    },
    body: JSON.stringify({
      event: "user.created",
      user_id: user.id,          // un id estable. No mandes emails ni nombres.
      created_at: new Date(user.createdAt).toISOString(),
      idempotency_key: `signup:${user.id}`, // reintentar no cuenta dos veces
    }),
  });

  // UN 202 NO ES "SALIÓ BIEN": trae adentro lo que rechazó, y un evento
  // rechazado se ve igual que todo en orden si no se mira.
  const { rejected } = await res.json();
  if (rejected?.length) console.warn("[hmu]", rejected);
}

<!-- HowManyUsers — desde el navegador. Alimenta la analítica (dispositivo,
     navegador, país, referente). NO cuenta usuarios: eso sólo lo puede hacer
     tu servidor con la clave secreta, y es lo que hace que el número valga. -->
<script>
  fetch("https://howmanyusers.wtf/api/v1/events", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: "Bearer hmu_pk_live_..._TU_CLAVE_PUBLICA",
    },
    body: JSON.stringify({ event: "page.viewed" }),
  });
</script>