Skip to Content
Referrals

Referrals

Invite people to almyty and you both get free Pro time. Share your personal link; when someone signs up with it they start with 30 days of Pro, and you earn more Pro days as they start using almyty and when they become a paying customer.

  1. Open Settings → Billing → Referrals.
  2. Click Copy next to your link and send it to whoever you want to invite.

Everyone has one permanent link. The same page shows how many people you Invited, how many Qualified, how many were Rewarded, your Reward days, and a list of Your referrals with their status and the days each earned you. It never shows who the people are.

What you both get

  • They get 30 days of Pro as soon as they sign up with your link.
  • You get 14 days of Pro when their organization is up and running: it has at least one gateway and has completed at least one agent run.
  • You get 30 more days if their organization starts a paid plan. The free Pro trial does not count.

Rewards are checked every 10 minutes, so they arrive shortly after the milestone rather than instantly.

Good to know:

  • Rewards extend how long your organization has Pro. There is no cash or credit.
  • You can earn at most 365 days in any 365-day period. Past that, a reward is cut down to what fits.
  • If your organization is on the free plan when a reward arrives, the days are saved and applied automatically once it is on Pro.
  • Enterprise organizations cannot take part, on either side.
  • If someone clicks several people’s links, the last link they clicked counts. A link is remembered for 30 days.

When a referral is held for review

Two things put a referral on hold: signing up with a throwaway email address, or signing up from the same internet address the link was made from (or as an earlier referral of yours). A held referral shows as Pending review. The new user gets no sign-up bonus and it earns you nothing until an operator clears it.

For developers

  • Share links look like https://app.example.com/r/AB3D7XKQ (an 8-character code); /auth/register?ref=CODE works too.
  • The link sets an httpOnly attribution cookie, almyty_ref, for 30 days and redirects to registration. Attribution is last-touch; the cookie is consumed at registration.
  • The /r/<code> endpoint is rate-limited to 20 requests an hour per IP. Appending ?format=json returns {"attributed": true|false} instead of a redirect.
  • Rewards extend the organization’s planExpiresAt. Days banked on the free plan are accruedRewardDays; the total is totalRewardDays.
  • Referral statuses: pending, then qualified (activation, +14 days), then rewarded (paid conversion, +30 days, final). Held referrals are pending_review, flagged disposable_email or same_ip.
  • The same data is under /referrals in the API reference.

Configuration (self-hosting). Environment variables on the backend:

VariableDefaultMeaning
REFERRAL_REFEREE_DAYS30the new user’s Pro trial at signup
REFERRAL_TIER1_DAYS14your reward on activation
REFERRAL_TIER2_DAYS30your reward on paid conversion
REFERRAL_YEARLY_CAP_DAYS365rolling 365-day cap on your rewards
REFERRAL_SWEEP_INTERVAL_MS600000how often rewards are checked (10 minutes)

FRONTEND_URL is used to build share links and the redirect after attribution.