formdata.dev

forms

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

npx formdata-dev forms <list|create|get|deliveries|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 admin@acme.com (enabled)

Errors

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

MCP equivalent: get_form

forms deliveries

Show recent delivery attempts for a form. This surfaces metadata only: submission ID, destination, attempt number, response code, error, and timestamp.

npx formdata-dev forms deliveries <formId> [limit]

Output

Recent Deliveries: Contact Form ─────────────────────────────── delivered 2026-03-19T09:15:00.000Z webhook attempt 1 Submission: 550e8400-e29b-41d4-a716-446655440000 Destination: d1e2f3a4-5678-4abc-9123-abcdef123456 Response: 200 retrying 2026-03-19T09:14:30.000Z smtp attempt 2 Submission: 8d4f2f7e-87b4-4713-9f54-724d1b0ef321 Destination: c7d8e9f0-1234-4def-8123-bcdef0123456 Error: Connection reset

Notes

  • The default limit is 10
  • The maximum limit is 100
  • Records are retained for 7 days
  • Submission payloads are never stored here

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