Skip to main content

Tracking Free Signups (Leads)

In Endorsely, you can track free signups as Leads — keeping them separate from your paid customers. This gives valuable insights to both you and your affiliates:

  • For you: See which affiliates are sending free signups (potential future customers who may upgrade to paid)
  • For your affiliates: Helps keep them motivated by showing their efforts are working, even if those signups haven't upgraded yet

When affiliates can see that their content is generating leads, they're more likely to keep promoting your brand.

Integration Steps​

Step 1: Get your API key​

To track free signups, you'll need your Endorsely API key:

  • If you're using Stripe and haven't generated an API key yet, do that first in your Endorsely account
  • If you already have an API key, you can continue using the same one

Step 2: Send Free Signup Data to Endorsely​

When a user signs up for your software (free plan), you'll need to send their signup data to Endorsely using our API. This lets us log the signup as a Lead and credit the correct affiliate.

important

Make sure to include the endorsely_referral value (the referral code) when sending the data.

await fetch("https://app.endorsely.com/api/public/refer", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer YOUR_API_KEY",
  },
  body: JSON.stringify({
    status: "Signed Up",
    referralId: endorselyReferral,
    email: userEmail,
    organizationId: "YOUR_ORGANIZATION_ID",
    // Add any other relevant signup data here
  }),
});

You can trigger this API call immediately after signup — either directly in your signup flow or in the background.

Once the call is made, the lead will show up in your Endorsely dashboard, linked to the correct affiliate.

If you need help setting this up, feel free to contact our support team — we're happy to assist!