CLI Reference
hogsend contacts
List, inspect, and trace contact activity on a running Hogsend instance via the admin API.
Inspect contacts via the running app's admin API (/v1/admin/contacts).
hogsend contacts <subcommand> [options]The global --url, --admin-key, and --json flags apply — see the CLI Reference overview for connection details.
Subcommands
| Subcommand | What it does |
|---|---|
list | List contacts, newest activity first. |
get <id> | Get one contact (by id or externalId) plus preferences. |
timeline <id> | Merged event / email / journey activity for a contact. |
Options
list:
| Option | Description |
|---|---|
--search <q> | Filter by email / externalId substring. |
--limit <n> | Page size (1–100, default 50). |
--offset <n> | Page offset (default 0). |
timeline:
| Option | Description |
|---|---|
--type <t> | Restrict to one of event, journey, or email. |
--limit <n> | Page size (1–100, default 50). |
--offset <n> | Page offset (default 0). |
Examples
hogsend contacts list --search acme@ --json
hogsend contacts get user_123
hogsend contacts timeline user_123 --type email --json