Docs


Getting Started

Here's how to get your waitlist rolling in no time. 1. Register and log in to your account on https://onwaitlist.co. 2. Copy one of the examples and adjust according to your needs. 3. Add it to your project and you are good to go! Additionally you can fine tune how many points each referral gets, your weekly growth goals or roll your own implementation using the API.

Sign up Info

For each of your domains you'll get an URL to send sign ups to. https://onwaitlist.co/in/{token} where {token} will be a uniquely generated id. Set your form method to GET and form action to the URL for your domain.
                            
    <form method="GET" action="https://onwaitlist.co/in/{token}">
        ...
    </form>
                            
                        
Mandatory fields On waitlist... needs only an email field to get your sign ups recorded.
                            
    <form method="GET" action="https://onwaitlist.co/in/{token}">
        <input type="email" name="email" placeholder="Email address" required/>
        <button type="submit">Subscribe</button>
    </form>
                            
                        
Referral Code (Optional) You can send a Referral Code with your form by adding a referral_code field.
                            
    <form method="GET" action="https://onwaitlist.co/in/{token}">
        <input type="email" name="email" placeholder="Email address" required/>
        <input type="text" name="referral_code" value="123456" />
        <button type="submit">Subscribe</button>
    </form>
                            
                        
Additional Data (Optional) You can send additional data for your sign ups just by adding more fields to your form. Note: currently only text and number fields are supported.
                            
    <form method="GET" action="https://onwaitlist.co/in/{token}">
        <input type="email" name="email" placeholder="Email address" required/>
        <input type="text" name="referral_code" value="123456" />
        <input type="text" name="is_it_friday"  value="no" />
        <button type="submit">Subscribe</button>
    </form>
                            
                        
After successful sign up Your sign ups will be redirected to a Thank you page informing them of their position on the waitlist and how to climb the waitlist by sharing on social media.

Using Forms

Use these examples to jump start your waitlist sign ups. Refer to the Sign Up Info section for details about the data you can send.
Mandatory
    
    <form method="GET" action="https://onwaitlist.co/in/{token}">
        <input type="email" name="email" placeholder="Email address" required/>
        <button type="submit">Subscribe</button>
    </form>
    
With Referral
    
    <form method="GET" action="https://onwaitlist.co/in/{token}">
        <input type="email" name="email" placeholder="Email address" required/>
        <input type="text" name="referral_code" placeholder="Referral code"/>
        <button type="submit">Subscribe</button>
    </form>
    
With Additional Data

    <form method="GET" action="https://onwaitlist.co/in/{token}">
        <input type="email" name="email" placeholder="Email address" required/>
        <input type="text" name="referral_code" placeholder="Referral code"/>
        <input type="text" name="country" placeholder="Country"/>
        <button type="submit">Subscribe</button>
    </form>

HTML
    
    <form id="waitlistSubscribeForm" method="GET" action="https://onwaitlist.co/in/{token}">
        <input type="email" name="email" placeholder="Email address" required/>
        <button id="waitlistSubscribe" type="submit">Subscribe</button>
    </form>
    
jQuery
    
    <script type="text/javascript">
        $(document).ready(function(){
           $("#waitlistSubscribeForm").submit(function(e) {
                var form = $(this);

                var formData = {
                    'email': form.find("input[name=email]"),
                    // 'referral_code': form.find("input[name=referral_code]"),
                    // 'other_value': form.find("input[name=other_value]")
                };

                $.ajax({
                    type: form.attr("method"),
                    url: form.attr("action"),
                    data: formData,
                    dataType: 'json',
                    encode: true
                }).done(function (data) {
                    console.log(data);
                    // Here you display a message for example
                });

                e.preventDefault();
           })
        });
    </script>

    
    
    import React, {useState} from 'react';
    import axios from 'axios';

    function OnTheListSubscribe() {
        const [email, setEmail] = useState('');
        const [subscribed, setSubscribed] = useState(false);

        function onChangeEmail(value) {
            setEmail(value);
        }

        function onSubmitSubscribe(e) {
            e.preventDefault();
            axios.get('https://onwaitlist.co/in/{token}')
                .then(result => {
                    const {data} = result;
                    // use data elsewhere if you need to
                    setSubscribed(true);
                });
        }

        return (
            {!subscribed ? (
                <form onSubmit={onSubmitSubscribe}>
                    <input type="email" name="email" onChange={e => onChangeEmail(e.target.value} value={email} placeholder="Email address" required/>
                    <button type="submit">Subscribe</button>
                </form>
            ) : (
                <p>Thank you for joining the waitlist!</p>
            )
        );
    }

    export default OnTheListSubscribe;

    

Using the API

One simple API for your waitlist. Request POST https://onwaitlist.co/api/in/{token} email - Mandatory field referral_code - Optional, send a referral_code for the sign up is_is_friday - Optional, additional data you want to send. You can send as many additional text/number fields as you want. Response The response will contain an object will the following values: email - The email that signed up to your waitlist position - Position of the sign up in your waitlist referralCode - Referral code used for the sign up referralUrl - Referrl URL that can be used for sharing (the URL redirects to your domain) data - Any additional data you've sent for the sign up (key: value pairs)