---
title: "Create a new form"
method: POST
path: "/api/v3/projects/{project_id}/forms"
tags: ["forms"]
---

# Create a new form

`POST /api/v3/projects/{project_id}/forms`

## Path parameters

- `project_id` string, uuid, required

## Headers

- `Fieldwire-Version` string, date, required

## Request body

- FormCreateInput — Schema for creating forms
  - `id` string, uuid — ID of the entity
  - `creator_user_id` integer, required — ID of the user who created this entity
  - `last_editor_user_id` integer, required — ID of the user who most recently edited this entity
  - `owner_user_id` integer, required — ID of the user who owns this form
  - `form_template_form_status_id` string, uuid, required — ID of the status this form currently is in
  - `form_template_id` string, uuid, required — ID of the template this form was created from
  - `is_generated` boolean — Whether this form is fully generated (in case cloning from another form)
  - `checksum` string, required — Checksum used for verifying whether all relevant structural information for a form is at hand
  - `name` string, required — Name of the entity
  - `kind` 'default' | 'time_range' | 'single_day' — Kind of the entity
  - `version` integer — Version of the template this form was built out of
  - `device_created_at` string, date-time — Time when the device created the form
  - `device_updated_at` string, date-time — Time when the device last updated the form
  - `end_at` string, date-time, nullable — Time when this form is marked as ending
  - `start_at` string, date-time, nullable — Time when this form is marked as starting
  - `due_date` string, date, nullable — Time when this form is marked as due
  - `form_type` 'default' | 'fillable_pdf' — The type of form either custom fieldwire or a fillable_pdf

## Response `201`

Successful response

- Form — Entity that denotes a form
  - `id` string, uuid, required — ID of the entity
  - `creator_user_id` integer, required — ID of the user who created this entity
  - `last_editor_user_id` integer, required — ID of the user who most recently edited this entity
  - `owner_user_id` integer, required — ID of the user who owns this form
  - `form_template_form_status_id` string, uuid, required — ID of the status this form currently is in
  - `form_template_id` string, uuid, required — ID of the template this form was created from
  - `project_id` string, uuid, required — ID of the project this entity belongs to
  - `is_generated` boolean, required — Whether this form is fully generated (in case cloning from another form)
  - `checksum` string, required — Checksum used for verifying whether all relevant structural information for a form is at hand
  - `name` string, required — Name of the entity
  - `kind` 'default' | 'time_range' | 'single_day', required — Kind of the entity
  - `sequence_number` integer, required — Unique number that denotes this form scoped to the template
  - `version` integer, required — Version of the template this form was built out of
  - `created_at` string, date-time, required — Time when the server created the form
  - `deleted_at` string, date-time, nullable — Time the server deleted the form
  - `device_created_at` string, date-time, required — Time when the device created the form
  - `device_updated_at` string, date-time, required — Time when the device last updated the form
  - `end_at` string, date-time, nullable — Time when this form is marked as ending
  - `start_at` string, date-time, nullable — Time when this form is marked as starting
  - `due_date` string, date, nullable — Time when this form is marked as due
  - `due_date_notified` boolean, nullable — Whether due date notification for this form has been sent
  - `resolved_conflict` boolean, nullable, required — Specifies if PUT/PATCH request was rejected - do not store this field!
  - `updated_at` string, date-time, required — Time when the server last updated the form
  - `view_edit_permissions` 'assignee' | 'all_users' | 'null', nullable — View/edit permissions for the form, e.g. assignee, all_users. Consider using form_permissions instead.
  - `form_type` 'default' | 'fillable_pdf', required — The type of form either custom fieldwire or a fillable_pdf

---

[API](https://skmtc.dev/fieldwire/apis/fieldwire-super-api.md) · [All operations](https://skmtc.dev/fieldwire/apis/fieldwire-super-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fieldwire/fieldwire-super-api/revisions/66ee1c20b92d/schema)