Waitlist API Template

email	name	source	created_at	status
john@example.com	John Doe	landing-v1	2026-01-30	pending
jane@example.com	Jane Smith	twitter	2026-01-30	invited
...	...	...	...	...

Code Examples

waitlist-form.html
<form id="waitlist-form">
  <input type="email" name="email" placeholder="Enter your email" required>
  <input type="text" name="name" placeholder="Your name (optional)">
  <button type="submit">Join Waitlist</button>
</form>

<script>
document.getElementById('waitlist-form').addEventListener('submit', async (e) => {
  e.preventDefault();
  
  const formData = new FormData(e.target);
  
  const response = await fetch('https://api.getsheetapi.com/api/v1/YOUR_SHEET_ID', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      email: formData.get('email'),
      name: formData.get('name') || '',
      source: 'landing-page',
      created_at: new Date().toISOString().split('T')[0],
      status: 'pending'
    })
  });
  
  if (response.ok) {
    alert('Thanks! You\'re on the list.');
  }
});
</script>

waitlist.js
async function addToWaitlist(email, name = '') {
  const response = await fetch('https://api.getsheetapi.com/api/v1/YOUR_SHEET_ID', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      email,
      name,
      source: window.location.pathname,
      created_at: new Date().toISOString().split('T')[0],
      status: 'pending'
    })
  });
  
  return response.json();
}

// Usage
addToWaitlist('user@example.com', 'John Doe')
  .then(data => console.log('Added:', data))
  .catch(err => console.error('Error:', err));

WaitlistForm.jsx
import { useState } from 'react';

const SHEET_ID = 'YOUR_SHEET_ID';
const API_KEY = 'YOUR_API_KEY';

export function WaitlistForm() {
  const [email, setEmail] = useState('');
  const [status, setStatus] = useState('idle'); // idle | loading | success | error
  
  const handleSubmit = async (e) => {
    e.preventDefault();
    setStatus('loading');
    
    try {
      const res = await fetch(`https://api.getsheetapi.com/api/v1/${SHEET_ID}`, {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'X-API-Key': API_KEY
        },
        body: JSON.stringify({
          email,
          source: 'react-app',
          created_at: new Date().toISOString().split('T')[0],
          status: 'pending'
        })
      });
      
      if (res.ok) {
        setStatus('success');
        setEmail('');
      } else {
        setStatus('error');
      }
    } catch {
      setStatus('error');
    }
  };
  
  if (status === 'success') {
    return <p>🎉 You're on the list!</p>;
  }
  
  return (
    <form onSubmit={handleSubmit}>
      <input
        type="email"
        value={email}
        onChange={(e) => setEmail(e.target.value)}
        placeholder="Enter your email"
        required
      />
      <button type="submit" disabled={status === 'loading'}>
        {status === 'loading' ? 'Joining...' : 'Join Waitlist'}
      </button>
      {status === 'error' && <p>Something went wrong. Try again.</p>}
    </form>
  );
}

Terminal
# Add a new signup
curl -X POST https://api.getsheetapi.com/api/v1/YOUR_SHEET_ID \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "email": "user@example.com",
    "name": "John Doe",
    "source": "terminal",
    "created_at": "2026-01-30",
    "status": "pending"
  }'

# Get all signups
curl https://api.getsheetapi.com/api/v1/YOUR_SHEET_ID \
  -H "X-API-Key: YOUR_API_KEY"

# Filter by status
curl "https://api.getsheetapi.com/api/v1/YOUR_SHEET_ID?status=pending" \
  -H "X-API-Key: YOUR_API_KEY"