<aside> 💡 Our well-documented API is quick and easy to integrate. Highly flexible so you can add on your custom logic around the process. Just remember to showcase the response [see response object below] to the user once they sign up. That way, they receive their referral link to refer friends and see their spot on the waitlist.
If you need a route for users to check their status later, consider using [x] Querying User Information.
</aside>
POST <https://getwaitlist.com/api/v1/waitlists/submit>
email [string]: The email of the user who is signing up on your waitlist.
api_key [string]: Your API key
referral_link [string]: Please fetch the CURRENT website link. In javascript, I used document.URL; to fetch this. It's important to fetch the full link as this is how we fetch potential referral ids.
{
"api_key": "key_123",
"email": "new@signup.com",
"referral_link": "www.mywebsite.com?&ref_id=1234"
}
current_priority [integer]: Current priority of user on the Waitlist (if you're using it for the purpose of a waitlist)
referral_link [string]: The referral link of the user who signed up
registered_email [string]: Email of the user that signed up. We return this so it's easier for you to show.
total_users [integer]: Total users on the waitlist. It gives the users an idea of how far ahead or behind on the waitlist they are.
total_referrals [integer]: Total number of successful referrals for this specific user (it will be 0 at first, but if the user signs up again by accident, we show their number of referral)
user_id [string]: A hash-value for the user on your waitlist. If you wish to create a traceable, yet unique, link for users, feel free to use this.
{
"current_priority": 1,
"referral_link": "<https://yaywaitlist.com?&ref_id=CQGBZ6M5Y>",
"registered_email": "new@signup.com",
"total_referrals": 0,
"total_users": 10321,
"user_id": "577a68e3fbf501fda5e7959518c3bc3d"
}
400: Validation error or missing parameter. Please check that the email or api_key is wrong