inbound

jetemail inbound covers everything under /inbound/…. Authentication uses your api_… key.

inbound
├── account
│   ├── allowlist     list | get | create | update | delete
│   ├── blocklist     list | get | create | update | delete
│   └── logs          GET /inbound/account/logs (supports --tail)
├── domains
│   ├── list
│   ├── create        (alias: add)
│   ├── delete <uuid>
│   ├── check <uuid>
│   └── forward-rules list | add | get | update | delete
├── filters
│   ├── allowlist     list | get | create | update | delete
│   └── blocklist     list | get | create | update | delete
├── destinations      list | verify <token> | resend <uuid>
├── logs              GET /inbound/logs (supports --tail)
├── quarantine release <uid>
└── settings          get <uuid> | update <uuid>

`inbound domains`

jetemail inbound domains list
jetemail inbound domains create --domain inbox.example.com --delivery-type forward
jetemail inbound domains check <uuid>
jetemail inbound domains delete <uuid>

`create` flags

Flag	Description
`--domain <name>`	Domain to add (e.g. `inbox.example.com`).
`--delivery-type <type>`	`smtp`, `webhook`, or `forward`.
`--smtp-server <host:port>`	Destination server. Repeatable. (`smtp` only)
`--webhook-url <url>`	Endpoint to deliver to.
`--webhook-method <verb>`	`POST` (default), `PUT`, etc.
`--webhook-header 'Name: Value'`	Custom request header. Repeatable.
`--webhook-timeout <secs>`	Per-request timeout.
`--webhook-retry-count <n>`	Retry attempts.
`--webhook-auth-header <h>`	Authorization header value.
`--body-json <src>` / `--field k=v`	Raw body access. See Body escape hatches.

jetemail inbound domains create \
  --domain inbox.example.com \
  --delivery-type webhook \
  --webhook-url https://api.example.com/inbound \
  --webhook-header 'Authorization: Bearer xyz' \
  --webhook-timeout 30

`inbound domains forward-rules`

Per-domain forwarding rules.

jetemail inbound domains forward-rules list <domain-uuid>

jetemail inbound domains forward-rules add <domain-uuid> \
  --localpart sales \
  --destination 'sales-team@yourcompany.com' \
  --active true

jetemail inbound domains forward-rules get <domain-uuid> <rule-uuid>
jetemail inbound domains forward-rules update <domain-uuid> <rule-uuid> --destination new@example.com
jetemail inbound domains forward-rules delete <domain-uuid> <rule-uuid>

See Forwarding.

`inbound account` (account-level rules and logs)

Account-scoped allowlist and blocklist rules apply across every inbound domain you own.

jetemail inbound account allowlist list
jetemail inbound account allowlist create --name "trusted-vendor" --sender '*@vendor.com'
jetemail inbound account allowlist get <rule-uuid>
jetemail inbound account allowlist update <rule-uuid> --enabled false
jetemail inbound account allowlist delete <rule-uuid>

# Same shape for blocklist:
jetemail inbound account blocklist list
jetemail inbound account blocklist create --name "spam-domain" --sender '*@phishy.example'

Rule body flags

These apply to both create and update:

Flag	Description
`--name <str>`	Human-readable rule name. Required for create.
`--description <str>`	Optional notes.
`--enabled <bool>`	Toggle the rule (update only).
`--sender <pattern>`	Repeatable.
`--recipient <pattern>`	Repeatable.
`--subject <pattern>`	Repeatable.
`--body <pattern>`	Repeatable.
`--header <pattern>`	Repeatable. Free-form.
`--ip <pattern>`	Repeatable.
`--attachment <pattern>`	Repeatable.
`--body-json` / `--field k=v`	See Body escape hatches.

Account logs

jetemail inbound account logs --limit 50
jetemail inbound account logs --logtype spam --date-from 1715126400
jetemail inbound account logs --tail

Supports the same filter flags as the account logs API (--logtype, --from, --to, --subject, --ip, --date-from, --date-to, --spamscore-min, --spamscore-max, --host, --port, --mode, plus --limit/--offset/--page/--sort-by/--sort-order). --tail opens the live TUI. See Live log tail.

`inbound filters` (per-domain allow/blocklist)

Domain-scoped equivalents of the account rules. The shape is identical, plus the list and create actions take --domain, --subdomain-id, or --subdomain-uuid to scope to a domain.

jetemail inbound filters allowlist list --domain example.com
jetemail inbound filters allowlist create --domain example.com \
  --name "ship-from-shopify" --sender 'noreply@shopify.com'
jetemail inbound filters allowlist update <rule-uuid> --enabled false
jetemail inbound filters allowlist delete <rule-uuid>

jetemail inbound filters blocklist list --domain example.com

See Inbound rules.

`inbound destinations`

Forwarding destinations (the addresses you forward verified mail to).

jetemail inbound destinations list
jetemail inbound destinations verify <token>          # consumes the verification token from the email link
jetemail inbound destinations resend <uuid>           # re-send the verification email

See Destination verification.

`inbound logs`

jetemail inbound logs --limit 50
jetemail inbound logs --uuid <domain-uuid> --logtype spam
jetemail inbound logs --tail
jetemail inbound logs --tail --logtype spam --poll-secs 10

Supported filters: --uuid, --subdomain-id, --uid, --logtype, --subject, --from, --to, --spamscore-min, --spamscore-max, --host, --ip, --date-from, --date-to, plus pagination (--limit, --offset, --page, --sort-by, --sort-order). --tail flags: --poll-secs N (default 5), --buffer N (default 500).

`inbound quarantine release`

Release a quarantined message by UID.

jetemail inbound quarantine release <uid>

See Release from quarantine.

`inbound settings`

Per-domain inbound settings.

jetemail inbound settings get <domain-uuid>

jetemail inbound settings update <domain-uuid> \
  --status active \
  --delivery-type smtp \
  --smtp-server mx.example.com:25

`update` flags

Flag	Description
`--status <state>`	`active` or `disabled`.
`--delivery-type <type>`	`smtp`, `webhook`, or `forward`.
`--smtp-server <host:port>`	Repeatable (smtp).
`--webhook-url <url>`	Endpoint to deliver to (webhook).
`--webhook-method <verb>`	HTTP method.
`--webhook-header 'Name: Value'`	Repeatable.
`--webhook-timeout <secs>`	Per-request timeout.
`--webhook-retry-count <n>`	Retry attempts.
`--webhook-auth-header <h>`	Auth header value.
`--body-json` / `--field k=v`	See Body escape hatches.

Getting Started

Output & I/O

Commands

Workflows

`inbound domains`

`create` flags

`inbound domains forward-rules`

`inbound account` (account-level rules and logs)

Rule body flags

Account logs

`inbound filters` (per-domain allow/blocklist)

`inbound destinations`

`inbound logs`

`inbound quarantine release`

`inbound settings`

`update` flags

​inbound domains

​create flags

​inbound domains forward-rules

​inbound account (account-level rules and logs)

​Rule body flags

​Account logs

​inbound filters (per-domain allow/blocklist)

​inbound destinations

​inbound logs

​inbound quarantine release

​inbound settings

​update flags

​Related

`inbound domains`

`create` flags

`inbound domains forward-rules`

`inbound account` (account-level rules and logs)

Rule body flags

Account logs

`inbound filters` (per-domain allow/blocklist)

`inbound destinations`

`inbound logs`

`inbound quarantine release`

`inbound settings`

`update` flags

Related