Forms

A form collects answers from the people who fill it in, and each completed form is a submission. For fields and response details, see the API reference for forms, a single form, creating a form and form actions. To read submissions, see Submissions.

List forms

This command lists every form in the workspace, oldest first by default; pass --order desc for newest first. Use this when you want a form’s id, or use --status to narrow the list to active, archived, or favorite forms and --search to find a form by the words in its title.

neetoform forms list --status active --page-size 2 --json

neetoform forms list --search "onboarding feedback" --json

Flag	Type	Default	Description
`--order`	`string`		Sort by creation time: asc (oldest first, default) or desc
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page (max 100)
`--search`	`string`		Words that must all appear in the form title
`--status`	`string`		Filter by status: active, archived, favorite

Sample output (--json)

{
  "data": [
    {
      "id": "7db4b04a-6e17-4af6-a1d6-650c4cba3f91",
      "title": "Customer feedback",
      "is_published": true,
      "state": "published",
      "created_at": "2026-01-15T10:30:00.000Z",
      "updated_at": "2026-02-02T14:45:00.000Z",
      "attempt_url": "https://acme.neetoform.com/a06b5843f9e0faab8746",
      "submissions_count": 128,
      "is_archived": false,
      "is_disabled": false,
      "is_suspended": false,
      "created_by": "Oliver Smith"
    },
    {
      "id": "b4c8c9b6-7510-4d69-9a6b-37a92c3ae62b",
      "title": "Event registration",
      "is_published": false,
      "state": "draft",
      "created_at": "2026-02-11T09:02:00.000Z",
      "updated_at": "2026-02-11T09:20:00.000Z",
      "attempt_url": "https://acme.neetoform.com/2c1f7ad9e64b5a03bd11",
      "submissions_count": 0,
      "is_archived": false,
      "is_disabled": false,
      "is_suspended": false,
      "created_by": "Sam Smith"
    }
  ],
  "breadcrumbs": [
    {
      "label": "Submissions",
      "command": "neetoform forms submissions list <form-id>"
    }
  ],
  "pagination": {
    "current_page_number": 1,
    "total_pages": 12,
    "total_records": 23,
    "page_size": 2
  }
}

--status accepts only active, archived, or favorite. Anything else is rejected before a request is made. --order accepts only asc or desc. --search keeps forms whose title contains every word, case-insensitive, and includes archived forms unless --status narrows the list. The id in each record is the form id every other command and endpoint takes. See Getting the Form ID for the other ways to find it.

Show a form

This command shows one form with its questions, in form order. Use this when you want to know what a form asks, or to take the column list for exporting its submissions.

neetoform forms show 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 --json

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list

Sample output (--json)

{
  "data": {
    "id": "7db4b04a-6e17-4af6-a1d6-650c4cba3f91",
    "title": "Contact sales",
    "is_published": true,
    "state": "published",
    "created_at": "2026-08-01T09:00:00.000Z",
    "updated_at": "2026-10-14T11:00:00.000Z",
    "attempt_url": "https://acme.neetoform.com/a06b5843f9e0faab8746",
    "submissions_count": 30,
    "is_archived": false,
    "is_disabled": false,
    "is_suspended": false,
    "created_by": "Oliver Smith",
    "questions": [
      {
        "id": "3a9b6c11-5d72-4e88-a0f3-91c47de2b6aa",
        "label": "Work email",
        "kind": "email",
        "slug": "work-email",
        "position": 1,
        "is_required": true,
        "is_hidden": false
      }
    ]
  },
  "breadcrumbs": [
    {
      "label": "Submissions",
      "command": "neetoform forms submissions list <form-id>"
    }
  ]
}

Create a form

This command creates a blank form. The new form is an unpublished draft. Use --created-by-email to set the owner; without it, the form belongs to the signed-in user.

neetoform forms create --title "Customer feedback" --style single_page --json

Flag	Type	Required	Description
`--created-by-email`	`string`		Email of the form owner; defaults to the signed-in user
`--style`	`string`		Form style: single_page (default) or one_question_at_a_time
`--title`	`string`	Yes	Form title, up to 80 characters

--style accepts only single_page or one_question_at_a_time. Anything else is rejected before a request is made.

Update a form

This command renames a form. The title is the only value you can change here. To change questions, see Questions.

neetoform forms update 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 --title "Customer feedback 2026"

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list

Flag	Type	Required	Default	Description
`--title`	`string`	Yes		New form title, up to 80 characters

Delete a form

This command moves one form to the trash. You can restore it from the trash in the app. The command runs at once and does not ask you to confirm.

neetoform forms delete 7db4b04a-6e17-4af6-a1d6-650c4cba3f91

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list

Delete many forms

This command moves several forms to the trash in one call. The call is all or nothing: if one id is unknown or not allowed, no form is deleted.

neetoform forms bulk-delete 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 b4c8c9b6-7510-4d69-9a6b-37a92c3ae62b

Required arguments:

<form-id>... - One or more form UUIDs

Archive, unarchive, enable, disable, favorite, and unfavorite forms

Each of these six commands changes the state of one or more forms and prints the updated forms. Every call is all or nothing: if one id is unknown or not allowed, no form changes.

neetoform forms archive 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 b4c8c9b6-7510-4d69-9a6b-37a92c3ae62b

neetoform forms unarchive 7db4b04a-6e17-4af6-a1d6-650c4cba3f91
neetoform forms enable 7db4b04a-6e17-4af6-a1d6-650c4cba3f91
neetoform forms disable 7db4b04a-6e17-4af6-a1d6-650c4cba3f91
neetoform forms favorite 7db4b04a-6e17-4af6-a1d6-650c4cba3f91
neetoform forms unfavorite 7db4b04a-6e17-4af6-a1d6-650c4cba3f91

Required arguments:

<form-id>... - One or more form UUIDs

enable and disable replace any submission deadline or limit set on the form.

Clone a form

This command copies a form as Clone of followed by the title. The copy keeps the published questions, theme, conditional logic, and thank-you page. It has no submissions, and it is an unpublished draft.

neetoform forms clone 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 --json

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list

Publish a form

This command publishes the draft of a form, so people can see your latest changes. If a question has errors, nothing is published and the errors are printed.

neetoform forms publish 7db4b04a-6e17-4af6-a1d6-650c4cba3f91

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list

Reset a form

This command throws away the draft changes of a form and goes back to the published version. The draft changes are lost and cannot be restored.

neetoform forms reset 7db4b04a-6e17-4af6-a1d6-650c4cba3f91

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list

Count forms

This command counts the forms you can see, as total, active, archived, and favorite forms. Favorite forms do not include archived ones.

neetoform forms counts --json

Sample output (--json)

{
  "data": {
    "total": 12,
    "active": 9,
    "archived": 3,
    "favorite": 2
  }
}

Transfer forms

This command moves forms to another workspace. It needs a signed-in CLI session, so it does not work with an API key, and you must be an admin of the destination workspace. After the move, integrations are disconnected, the forms get new public links, and the forms are disabled. Old links to the forms stop working.

neetoform forms transfer 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 --to acme-eu

Required arguments:

<form-id>... - One or more form UUIDs

Flag	Type	Required	Default	Description
`--to`	`string`	Yes		Subdomain of the destination workspace, where you are an admin

List submissions for a form

See Submissions.

Getting started

Commands

List forms

Show a form

Create a form

Update a form

Delete a form

Delete many forms

Archive, unarchive, enable, disable, favorite, and unfavorite forms

Clone a form

Publish a form

Reset a form

Count forms

Transfer forms

List submissions for a form

​List forms

​Show a form

​Create a form

​Update a form

​Delete a form

​Delete many forms

​Archive, unarchive, enable, disable, favorite, and unfavorite forms

​Clone a form

​Publish a form

​Reset a form

​Count forms

​Transfer forms

​List submissions for a form

List forms

Show a form

Create a form

Update a form

Delete a form

Delete many forms

Archive, unarchive, enable, disable, favorite, and unfavorite forms

Clone a form

Publish a form

Reset a form

Count forms

Transfer forms

List submissions for a form