formdata-dev CLI

Command-line interface for formdata.dev for creating accounts, managing forms, and routing submissions without a dashboard.

Quick Start

Run directly with npx:

npx formdata-dev init

Account signup is invite-only, so keep your invite code handy before you start.

The first run should answer one question quickly: can I get from zero to a working form endpoint without a dashboard?

The CLI will:

1. Create your account
2. Validate your invite code
3. Save credentials locally
4. Print your secret key (sk_...)
5. Offer to create your first form

Then manage your setup from the terminal:

npx formdata-dev forms create
npx formdata-dev destinations add
npx formdata-dev status

Once you're set up, status gives you the operational view you usually need: forms, public endpoints, and destinations.

Commands

Account

| Command | Description | |---------|-------------| | init | Create a new account interactively and store credentials locally | | status | Show account overview with all forms and destinations | | keys rotate | Rotate your secret key and revoke the previous key |

Forms

| Command | Description | |---------|-------------| | forms list | List all forms for your account | | forms create | Create a new form with interactive prompts | | forms get <id> | Show form details including destinations | | forms deliveries <id> [limit] | Show recent delivery attempts for a form | | forms update <id> | Update name, slug, allowed origins, or captcha settings | | forms delete <id> | Delete a form and all of its destinations |

Destinations

| Command | Description | |---------|-------------| | destinations list | List destinations for a form | | destinations add | Add a webhook, SMTP, or Google Sheets destination | | destinations rm <formId> <destId> | Remove a destination |

Options

| Flag | Description | |------|-------------| | --help, -h | Show help message | | --version, -v | Show version |

What It Supports

• JSON requests and native browser form submissions
• Webhook, email, and Google Sheets destinations
• MCP, CLI, and REST API management
• Local credential storage with reusable auth

This is the one GIF worth keeping here because it shows the submission shapes the service actually accepts.

Credential Storage

After npx formdata-dev init, credentials are saved to:

~/.config/formdata/credentials

The file is chmod 600 and contains your secret key (sk_...), API URL, organization name, and slug. The path respects XDG_CONFIG_HOME if set.

Links

• Website: https://formdata.dev
• Docs: https://docs.formdata.dev
• CLI guide: https://docs.formdata.dev/cli/overview