---
title: "Create a new form"
method: POST
path: "/forms"
tags: ["Forms"]
---

# Create a new form

`POST /forms`

Creates a subscription form linked to one or more lists.
Free users are limited to 1 form.

## Request body

- object
  - `title` string, required
  - `lists` integer[], required — Array of list IDs to attach
  - `redirect_url` string, uri, nullable — URL to redirect to after subscription
  - `gdpr_required` boolean — Whether GDPR consent checkbox is required

## Response `201`

Form created successfully

- Form
  - `id` integer
  - `title` string, required
  - `landing_page_id` integer, nullable
  - `redirect_url` string, nullable
  - `gdpr_required` boolean
  - `url` string — Public subscribe URL
  - `lists` ContactList[], required — Attached lists (included on create/update)
    - `id` integer
    - `name` string, required
    - `user_id` integer
    - `average_email_open_percent` number, float
    - `average_email_click_percent` number, float
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `403` — Forbidden (free user form limit reached)
- `422` — Validation error

---

[API](https://skmtc.net/sendfox/apis/sendfox-api.md) · [All operations](https://skmtc.net/sendfox/apis/sendfox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendfox/sendfox-api/revisions/ea591a7644e7/schema)