Waitlist

Form Action Endpoint

The form action endpoint allows you to point any HTML form directly to Waitlister to collect signups. This is perfect for integrating with no-code tools like Webflow, Framer, Bubble, or any custom HTML form without needing JavaScript embeds.

What is a Form Action Endpoint?

A form action endpoint is a URL that receives form submissions when a user clicks submit. Instead of handling the submission yourself, the form sends data directly to Waitlister, which processes the signup and redirects users to a thank-you page.

This approach is simpler than embedding forms and works with virtually any tool that supports HTML forms.

Why Use Form Action Endpoint?

The form action endpoint is ideal when:

• You're using no-code tools: Perfect for Webflow, Framer, Bubble, Wix, Squarespace, or any website builder
• You want complete design control: Style your form exactly how you want using your own tools
• You prefer simplicity: No JavaScript embeds or iframes to manage
• You're working with existing forms: Easily add waitlist functionality to forms you've already built
• You need native form behavior: Uses standard HTML form submissions that work everywhere

Form Action vs. Embeddable Form

Both methods support all Waitlister features including referrals, email validation, and analytics.

Getting Your Endpoint URL

To find your form action endpoint:

1. Navigate to your waitlist dashboard
2. Go to the "Overview" page
3. Your waitlist key is displayed at the top

Your endpoint URL will be:

https://waitlister.me/s/YOUR-WAITLIST-KEY

For a complete example with all supported fields, visit your endpoint URL in a browser to see the documentation page specific to your waitlist.

Basic Setup

Here's a minimal example to get started.

<form action="https://waitlister.me/s/YOUR-WAITLIST-KEY" method="POST">
  <input type="email" name="email" required>
  <button type="submit">Join Waitlist</button>
</form>

This form will collect signups and redirect users to a thank-you page — just make sure you've whitelisted the domain.

Supported Fields

The form action endpoint accepts the following fields.

Required Fields

Optional Fields

Custom Fields

Any field not listed above will be automatically stored in the subscriber's metadata. This allows you to collect additional information specific to your use case:

<form action="https://waitlister.me/s/YOUR-WAITLIST-KEY" method="POST">
  <input type="email" name="email" required>
  <input type="text" name="name">
  <input type="text" name="company">
  <input type="text" name="role">
  <select name="plan_interest">
    <option value="starter">Starter</option>
    <option value="pro">Pro</option>
  </select>
  <button type="submit">Join Waitlist</button>
</form>

In this example, company, role, and plan_interest will be saved as custom metadata.

Complete Example

Here's a full-featured form with all standard fields:

<form action="https://waitlister.me/s/YOUR-WAITLIST-KEY" method="POST">
  <!-- Required -->
  <label for="email">Email</label>
  <input 
    type="email" 
    id="email" 
    name="email" 
    required
  >
  
  <!-- Optional standard fields -->
  <label for="name">Name</label>
  <input 
    type="text" 
    id="name" 
    name="name"
  >
  
  <label for="phone">Phone</label>
  <input 
    type="tel" 
    id="phone" 
    name="phone"
  >
  
  <!-- Referral code (optional) -->
  <input 
    type="hidden" 
    name="referred_by" 
    value="happy-star-4f3d"
  >
  
  <!-- Custom fields (stored in metadata) -->
  <label for="company">Company</label>
  <input 
    type="text" 
    id="company" 
    name="company"
  >
  
  <button type="submit">Join Waitlist</button>
</form>

Domain Whitelisting

For security, you must whitelist the domain(s) where your form is hosted. Submissions from non-whitelisted domains will be rejected.

Adding Whitelisted Domains

1. Navigate to your waitlist dashboard
2. Go to "Overview" and click "Configure"
3. Scroll to the "Whitelisted domains" section
4. Add your domain (e.g., yoursite.com)
5. Click "Update domains"

Domain Format

• Enter domains without https:// or http://
• Correct: yoursite.com
• Incorrect: https://yoursite.com

Local Development

For testing locally, add:

• localhost (includes all ports)

Handling Referrals

To track referrals, include the referrer's code in the referred_by field.

<form action="https://waitlister.me/s/YOUR-WAITLIST-KEY" method="POST">
  <input type="email" name="email" required>
  <input type="hidden" name="referred_by" value="happy-star-4f3d">
  <button type="submit">Join Waitlist</button>
</form>

Dynamic Referral Codes

If you're capturing referral codes from URL parameters:

<!-- Example: yoursite.com/waitlist?ref=happy-star-4f3d -->
<form action="https://waitlister.me/s/YOUR-WAITLIST-KEY" method="POST">
  <input type="email" name="email" required>
  <input type="hidden" name="ref" id="referralCode">
  <button type="submit">Join Waitlist</button>
</form>

<script>
  // Get ref parameter from URL
  const urlParams = new URLSearchParams(window.location.search);
  const refCode = urlParams.get('ref');
  if (refCode) {
    document.getElementById('referralCode').value = refCode;
  }
</script>

Rate Limits

Form submissions are rate-limited based on your plan to prevent abuse.

Rate limit information is included in response headers.

• X-RateLimit-Limit: Maximum requests allowed
• X-RateLimit-Remaining: Requests remaining
• X-RateLimit-Reset: Time when the limit resets

Platform-Specific Guides

Webflow

1. Add a form element to your page
2. Select the form and open the settings panel
3. Set Action to https://waitlister.me/s/YOUR-WAITLIST-KEY
4. Set Method to POST
5. Add form fields with the correct name attributes:
   • Email field: name = email
   • Name field: name = name
   • Phone field: name = phone
6. Whitelist your Webflow domain in Waitlister settings

Framer

1. Add a Form component to your canvas
2. Add input fields inside the form
3. Set each field's name property:
   • Email input: email
   • Name input: name
   • Phone input: phone
4. Select the form and set:
   • Action: https://waitlister.me/s/YOUR-WAITLIST-KEY
   • Method: POST
5. Whitelist your Framer site domain in Waitlister settings

Bubble

1. Create a form element or use individual input fields
2. Add a button that triggers a workflow
3. In the workflow:
   • Add "Open an external website" action
   • Build the URL with query parameters or use a custom HTML element to submit a form
4. Alternatively, use an HTML element with a form tag and set the action URL
5. Whitelist your Bubble app domain in Waitlister settings

Custom HTML

For any platform that supports custom HTML:

<form action="https://waitlister.me/s/YOUR-WAITLIST-KEY" method="POST">
  <input type="email" name="email" placeholder="Enter your email" required>
  <input type="text" name="name" placeholder="Your name">
  <button type="submit">Join Waitlist</button>
</form>

Style the form with CSS to match your design.

Related Features

• Configure Waitlist - Set up domain whitelisting and other settings
• Referral Program - Learn about referral mechanics
• Thank-You Page - Customize the post-signup experience
• Analytics - Track signup performance
• API Reference - For programmatic integrations

Help and Support

Need assistance with the form action endpoint? We're here to help.

• Contact us via the public contact form
• Access the "Help" page in your account dashboard