Email Waitlist API

Quick Start

curl -X POST https://emailwaitlist.ayushojha.com/api/v1/projects \
  -H "X-Admin-Key: YOUR_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My App","slug":"my-app","allowed_origins":["https://myapp.com"]}'

fetch('https://emailwaitlist.ayushojha.com/api/v1/subscribe', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'wl_your_project_api_key'
  },
  body: JSON.stringify({
    email: 'user@example.com',
    metadata: { name: 'Jane', source: 'landing-page' }
  })
})

Step 1 — Register your site

Create a project to get an API key. Run this once per website (requires the admin key).

curl -X POST https://emailwaitlist.ayushojha.com/api/v1/projects \
  -H "X-Admin-Key: YOUR_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Website",
    "slug": "my-website",
    "allowed_origins": ["https://mywebsite.com"]
  }'

Save the api_key from the response — it starts with wl_ and won't be shown again.

Step 2 — Add the form to your frontend

Drop this into any page. Works with React, Vue, Svelte, plain HTML — anything that can call fetch.

async function subscribe(email, name) {
  const res = await fetch('https://emailwaitlist.ayushojha.com/api/v1/subscribe', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'wl_your_project_api_key'
    },
    body: JSON.stringify({
      email,
      metadata: { name, source: 'landing-page' }
    })
  });

  const data = await res.json();

  if (res.ok) {
    // Success — show confirmation
    return { success: true, message: data.message };
  } else if (res.status === 409) {
    // Already subscribed
    return { success: false, message: 'You're already on the list!' };
  } else if (res.status === 429) {
    // Rate limited
    return { success: false, message: 'Too many requests. Try again shortly.' };
  } else {
    return { success: false, message: data.error || 'Something went wrong.' };
  }
}

<form id="waitlist-form">
  <input type="email" id="wl-email" placeholder="you@example.com" required />
  <button type="submit">Join Waitlist</button>
  <p id="wl-msg"></p>
</form>

<script>
document.getElementById('waitlist-form').addEventListener('submit', async (e) => {
  e.preventDefault();
  const email = document.getElementById('wl-email').value;
  const msg = document.getElementById('wl-msg');

  const res = await fetch('https://emailwaitlist.ayushojha.com/api/v1/subscribe', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'wl_your_project_api_key'
    },
    body: JSON.stringify({ email })
  });

  const data = await res.json();
  msg.textContent = res.ok ? data.message : data.error;
});
</script>

Step 3 — Manage your subscribers

Use these endpoints with the same API key to view, export, or remove subscribers.

All requests require the X-API-Key header.

Response Handling Cheatsheet