Skip to main content
The CLI authenticates against authenticated Paubox endpoints (such as the Paubox Email API) using your API key and endpoint username. Run paubox auth login once and your credentials are stored securely; you won’t need to pass them on every command. To get your API key and endpoint username, go to Paubox Email API > Settings or follow the Quickstart guide.

​
Commands

CommandDescription
paubox auth loginPrompt for API username and key, validate, and store credentials
paubox auth logoutRemove stored credentials
paubox auth statusShow whether credentials are currently stored

​
auth login

paubox auth login

? Paubox API username: your_endpoint_username
? Paubox API key: ********************************
✓ Credentials verified and saved.
The CLI validates your credentials against the Paubox API before saving them. If validation fails, nothing is stored and an error is shown.

​
auth logout

paubox auth logout

✓ Credentials removed.
This removes the stored API key and username from wherever they were saved (keychain or config file).

​
auth status

paubox auth status

✓ Logged in as your_endpoint_username
If no credentials are stored: 
✗ Not logged in. Run `paubox auth login` to authenticate.

​
Where credentials are stored

PlatformStorage location
macOSmacOS Keychain
WindowsWindows Credential Vault
Linux (with libsecret)Secret Service (GNOME Keyring / KWallet)
Linux (without libsecret)~/.config/paubox/config.json with 0600 permissions
If your system falls back to file-based storage, never commit ~/.config/paubox/config.json to source control. Add it to your .gitignore if your home directory is under version control.
In CI environments, set credentials via environment variables instead of running auth login. The CLI reads PAUBOX_API_KEY and PAUBOX_API_USERNAME if present, and these take precedence over stored credentials.
paubox forms get and paubox forms submit call public Paubox Forms endpoints and do not require paubox auth login.