Skip to content
Last updated

Quick start

This guide walks you through creating an API key and listing the forms in your account.

Before you begin

In order to start building, you need to get a forms.app API from your account settings and see how to make a request.

All requests go to:

https://api.forms.app

Step 1: Create an API key

  1. Log in to forms.app.
  2. Click your avatar in the top-right corner and open Account Settings.
  3. Go to the API Keys tab.
  4. Click Create API Key, enter a descriptive name (for example, Production sync), and confirm.
  5. Copy the generated key immediately; it is shown only once.
  6. Store it securely, such as in an environment variable or secret manager.

You can create multiple keys (one per integration) and revoke any of them from the same API Keys page.

Step 2: Make your first request

List every form in your account with a single GET request. Pass your API key in the X-Api-Key header:

curl -s https://api.forms.app/v1/form \
  -H "X-Api-Key: YOUR_API_KEY"

Replace YOUR_API_KEY with the key you copied in step 1.

Example response

{
  "success": true,
  "data": [
    {
      "_id": "64f1a2b3c4d5e6f7a8b9c0d1",
      "title": "Customer feedback"
    },
    {
      "_id": "64f1a2b3c4d5e6f7a8b9c0d2",
      "title": "Event registration"
    }
  ],
  "errors": []
}

Each item includes the form's _id and title. Use _id with GET /v1/form/{id} to retrieve the full form structure.

Step 3: Inspect a single form

Pick an _id from the list above and fetch the complete form:

curl -s https://api.forms.app/v1/form/64f1a2b3c4d5e6f7a8b9c0d1 \
  -H "X-Api-Key: YOUR_API_KEY"

The response includes questions, design settings, thank-you pages, and more. See Fetching forms for a guided walkthrough.

What's next?

Guides

The essentials