Skip to content

CLI command

tinbox tokens create-send-key

Mint a transactional sending API key (returns plaintext ONCE). Distinct from `tokens create`, which is for inbox-scoped agent/MCP credentials.

Usage

sh
tinbox tokens create-send-key --name <name> --identity <identity> --domain <domain> [--account] --permission <permission> --ttl <ttl>

Flags

NameTypeRequiredDefaultDescription
--namestringyes—human label (default: cli-send-key-<date>)
--identitystringyes—scope to one sending identity id
--domainstringyes—scope to one sending domain id
--accountbooleanno—scope to the whole account (default when no scope flag is given)
--permissionstringyes—send | full (default send)
--ttlstringyes—expiry, e.g. 30d, 12h, 45m (units: s m h d w); omit = never expires