API Reference

/forms/{formId}/fields

post
https://www.formstack.com/api/v2025/forms//fields

Create a new field within the specified form

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The ID of the form

Body Params

Create Field request

string

Label of the field

string
enum
Defaults to text

Type of the field

string | null

Internal label of the field

string | null

Description of the field

boolean | null
Defaults to false

Flag to show the description in a callout box

boolean | null
Defaults to false

Flag to mark field as required

boolean | null
Defaults to false

Flag to not allow the field to be changed

boolean | null
Defaults to false

Flag to hide the field

boolean | null
Defaults to false

Flag to mark field as requiring a unique value

boolean | null
Defaults to false

Flag to show or hide the label

integer | null
Defaults to 1

Determines how many columns this field takes on the live form

string | null
enum
Defaults to default

Language of the field

string | null

Default value of the field on the live form

options
array of objects | null

Options attached to field

options
integer | null

ID of smart list to attach

boolean | null

Flag to unlink smart list from field

attributes

Field attributes component

logic

Field logic conditions for conditional processing

numericCalculation

Numeric calculation definition for this field

datetimeCalculation

Datetime calculation definition for this field

Responses

400

Invalid request body

403

Forbidden

404

Form not found

500

Unable to insert field

Updated about 2 months ago

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago