---
title: "Create User Form"
method: POST
path: "/v3.0/user-forms/"
tags: ["user-forms"]
---

# Create User Form

`POST /v3.0/user-forms/`

## Request

- Base URL: `https://api.formaloo.me`
- URL: `https://api.formaloo.me/v3.0/user-forms/`
- Auth: none declared. Required headers: `x-api-key`

## Headers

- `x-api-key` string, required
- `x-workspace` string

## Request body

- UserFormRequest
  - `default_roles` string[]
  - `title` string
  - `board` string
  - `signup_enabled` boolean
  - `login_enabled` boolean
  - `captcha_enabled` boolean
  - `otp_enabled` boolean
  - `sso_enabled` boolean
  - `paid_membership` boolean

## Response `201`

- UserForm
  - `form` FormSimpleShort
    - `slug` string, nullable
    - `address` string, nullable: A unique string to identify form for users. It's auto-generated if not set by user.
    - `title` string, nullable: the form's display name.
    - `category` SimpleCategory
      - `slug` string, nullable
      - `title` string, required
      - `color` string, nullable: category color settings or color code.
    - `show_submit_tracking_code` boolean: whether to show the tracking code after user has submitted the form.
    - `assign_submit_number` boolean: if set to true, each new row will have an incremental submit number starting from 1.
    - `accept_draft_answers` boolean: users can have draft answers on this form or not.
    - `ai_mode` boolean
    - `full_form_address` string
    - `version` string: version of form
    - `generate_pdf_for_user` boolean: whether to generate a pdf after each submit.
    - `generate_pdf_for_admin` boolean: whether to generate a pdf after each submit.
    - `last_export_start_time` string, date-time, nullable: when was last excel export task was started for the form?
    - `last_export_time` string, date-time, nullable: when was last excel export created.
    - `last_export_file` string, uri, nullable
    - `export_in_progress` boolean: Shows if there's an excel export task in progress for the form.
    - `submit_count` integer
  - `role_field` string
  - `sso_config` string
  - `default_roles` string[]
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `slug` string
  - `signup_enabled` boolean
  - `login_enabled` boolean
  - `captcha_enabled` boolean
  - `otp_enabled` boolean
  - `sso_enabled` boolean
  - `paid_membership` boolean
  - `form_fields` object

---

[API](https://skmtc.dev/formaloo/apis/formaloo-api-documentation.md) · [All operations](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/revisions/47b268aeb656?raw)