# 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](https://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:

```bash
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

```json
{
  "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:

```bash
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](/guides/tutorials/fetching-forms) for a guided walkthrough.

## What's next?

- Read [The essentials](/guides/the-essentials) for authentication options, the response envelope, and rate limiting.
- Follow [Fetching submissions](/guides/tutorials/fetching-submissions) to page through form answers.
- Browse the [API reference](/apis) for every endpoint and schema.