Getting Started

This guide walks you through creating your first AirForm site and submitting a test form.

1. Create an Account

Sign up at AirForm with your email or GitHub account.

2. Set Up Airtable

Before creating a site in AirForm, you need an Airtable base ready to receive data:

  1. Create a new base in Airtable
  2. Create a table with columns matching your form fields (e.g., Name, Email, Message)
  3. Note the Base ID — find it in the Airtable URL: https://airtable.com/appXXXXXXXXXXXXXX/...
  4. Create a Personal Access Token at airtable.com/create/tokens
    • Give it data.records:write scope
    • Grant access to your base

3. Create a Site

  1. Go to your Dashboard
  2. Click Create Site
  3. Enter your site name, Airtable Base ID, Table Name, and PAT
  4. Optionally set a Redirect URL — where users go after submitting (e.g., https://yoursite.com/thanks)

4. Add Domains

Add every domain that will submit forms to this site. For example:

  • example.com
  • www.example.com
  • localhost (for local development)

AirForm checks the Origin header on every submission and rejects requests from domains you haven't added.

5. Submit a Test Form

Your site's endpoint URL is shown on the site details page. It looks like:

https://airform.jossware.com/submit/{site_id}

Create a simple HTML form (see HTML Forms guide) and submit it. Check your Airtable base — the data should appear as a new row.