formdata.dev

forms

Manage form endpoints: list, create, inspect, update, and delete.

npx formdata-dev forms <list|create|get|update|delete>

forms list

List all forms in your account.

npx formdata-dev forms list

Output

Forms ───── ID Name Slug Enabled a1b2c3d4-... Contact Form contact yes e5f6a7b8-... Feedback feedback no
TIP

MCP equivalent: list_forms

forms create

Create a new form endpoint interactively.

npx formdata-dev forms create

Prompts

Prompt Required Description
Form name Yes Display name for the form
Form slug Yes URL-safe identifier (lowercase)
Allowed origins No Comma-separated origin URLs. Blank allows all origins
Enable captcha? Yes y/n -- if yes, prompts for captcha secret
Captcha secret If captcha enabled Your captcha provider secret key

Output

Create Form ─────────── Form name: Contact Form Form slug: contact Allowed origins (comma-separated, blank for any): Enable captcha? (y/n): n Done: Form created ID: a1b2c3d4-... Public key: pk_abc123... Endpoint: POST https://api.formdata.dev/v1/f/pk_abc123...
TIP

MCP equivalent: create_form

forms get

Show full details for a form including all destinations.

npx formdata-dev forms get <formId>

Output

Form: Contact Form ────────────────── ID: a1b2c3d4-... Slug: contact Public key: pk_abc123... Origins: https://acme.com, https://www.acme.com Captcha: off Enabled: yes Created: 2025-01-15T10:30:00Z Endpoint: POST https://api.formdata.dev/v1/f/pk_abc123... Destinations: d1e2f3a4-... smtp [email protected] (enabled)

Errors

  • Missing <formId> argument prints usage and exits
  • Invalid or nonexistent ID returns Not found
TIP

MCP equivalent: get_form

forms update

Update form settings interactively. Press Enter to keep any current value.

npx formdata-dev forms update <formId>

Prompts

Prompt Default Description
Name Current name New display name
Allowed origins Current origins Comma-separated list
Enabled (yes/no) Current state Enable or disable the form

Output

Update Form: Contact Form Press Enter to keep current value. Name [Contact Form]: Allowed origins (comma-separated) [https://acme.com]: Enabled (yes/no) [yes]: Done: Form updated Name: Contact Form Enabled: yes

If no fields change, prints No changes. and exits.

TIP

MCP equivalent: update_form

forms delete

Permanently delete a form and all its destinations.

npx formdata-dev forms delete <formId>

Confirmation

The CLI warns and requires confirmation:

Warning: This will permanently delete form "Contact Form" and all its destinations. Continue? (y/n):
WARNING

Deletion is permanent. All destinations attached to the form are also deleted. The public key stops accepting submissions immediately.

TIP

MCP equivalent: delete_form

ON THIS PAGE