LinkTrace docs

Custom backend: define success yourself, then send the lead

This is the most general auth integration path. Your app owns the auth logic completely. LinkTrace just records the resulting lead event.

Generic auth success tracking

Emit a lead when your own backend decides the auth action is complete.

await linktrace.trackLead(
  withFormAttribution(fromExpressRequest(req), req.body, {
    eventName: "signup",
    email: user.email,
    customerId: user.id,
  }),
)

What can count as success

LinkTrace does not define success. Your application does.

signup
login
email_verified
magic_link_completed
account_reactivated

Related guides

Docs home

Start with the product model, installation path, and implementation order.

API quickstart

Use secret keys, scopes, machine users, and server-side tracking safely.

Conversion tracking

Install the tracking script once, then send lead and sale events from your backend.