Mautic Community Forums

Referral Plugin

They there,

I’m happy to share our brand-new Referral plugin. This plugin enables to create referral campaigns, so that contacts can invite new contacts.

How it works
The plugin adds a new form field type ‘Referrals’. This field has a configuration to specify how many text inputs are shown in the form and what tags should be set on referred contacts.
Once the form is submitted and the email addresses are valid, a new contact is created for each specified email address, or updated if one already exists with the same email address.

The plugins keeps then a reference which contact invited the new contact (Referral). Additionally, you can use {referrerfield=...} tokens in emails to access contact fields of the referring contact. That enables you to build a campaign based on a segment that includes referred contacts (by filtering with the specified tag) and send a welcome email to those new contacts including for example the first name of the referring contact or a personal message.

Where to get it
The plugin is open source and available on GitHub:

Let me know what you think or if you have any questions.



Altough forum members seem not to comment, but we all appreciate it so I want to say thank you for this effort and making it public.


Thank you for the initiative and putting this together @simcen

@simcen , my friend it’s people like you that make the world go round and I just want to take a moment to appreciate that! and thank you from the bottom of my heart dude this is an amazing plugin simple but powerful, I can’t wait to see what it grows into.

Thanks a lot! Love that you started to create this plugin.

UPDATE: Errors were “trial and error” problems … as I missunderstood the concept.

@simcen - the reference between “referrer” and “referred contact” currently is only shown:

  • in the form and
  • in the history

of the “referred contact”? No custom fields?

Hey @simcen

Finally I was able to get some time to start playing with your plugin - it is GREAT - THANKS!!!

I have a question:
I would like to award points to people that refer others to the system and then somehow to award them more points if that person hits a specific page - is this at all possible ?

Thank you!
This plugin saved my ant job!
A suggestion?
Throw it on wordpress and set fire to the Facebook playground!