Maître Update #6: Referral API 0.1

TL;DR
The 6th update focuses on our referral APIs. And you are going to love this.

We have added some new referral API endpoints, improved stability and performance so that our API gives you, even more, flexibility.

New Endpoints

We have listened to your amazing feedback and added a few helpful endpoints:

/promote

Use the /promote endpoint to promote a subscriber. When you promote a subscriber, they will go to a separate list and won’t count towards the ranking. Useful if you are running weekly or monthly contests. Read here for more information about the “Promoted list”.

/retrieve_by_code

Use the /promote_by_code endpoint to retrieve a subscriber’s info using their referral code.

/retrieve_by_position

Use the /promote_by_position endpoint to retrieve a subscriber’s info using their position in the list. Useful if you need to know who is ahead or behind a specific subscriber.

/update points

Use the /update_points endpoint to update a subscriber’s points. Useful if you want to do some marketing promotion and reward some people for specific actions. (eg: invite a friend on Saturday and get 5 points).

Points and referral_points

As you know, points are at the core of our referral system. By default we assign 1 point when a person signs up and 1 point for each person they refer. For example, Tom signs up (1 point) and refers 4 people. He has got 5 points.

Now you can assign an arbitrary number of points for signing up and for referrals, by using the optional parameters points and referral points. (Check the documentation)

Why would you want to do that?
A common use would be to give more points (say 5) to the first 100 people who sign up onto the list to incentivise early sign ups. Another use would be assigning more points to people who share on a specific channel (eg: Facebook).

Or by re-engaging old subscribers who have dropped off by offering them a limited time extra points referral points. e.g 5 points / referral for 48 hours…

Logs

Last but not least we have added logs to the dashboard. You can see the logs of the last 300 calls alongside with basic information.

waiting-list-test3-mai%cc%82tre
Example of API logs

That’s it for this update. As usual, let me know what you think in the comments or ping me an email (hello@maitreapp.co).

If you liked this post you can subscribe to our newsletter and receive regular updates (don’t worry 1/week max. We are not THAT productive…)

Manuel

Maître's Founder. A data-driven, analytical geek who enjoys building stuff.

Leave a Reply

Your email address will not be published. Required fields are marked *