Guides

Quickstart

From a free account to a delivery and reply.

1. Authenticate

Create an account and confirm your email. Pair the CLI with your signed-in browser, then select a workspace.

Example

npm install -g @onedigitsa/inboxit
inboxit login
inboxit workspaces list
inboxit workspace use --id WORKSPACE_UUID

2. Verify your domain

Publish the returned ownership and DKIM TXT records at your DNS provider. Values are unique to your domain.

Example

inboxit domains add --name mail.yourbrand.com
inboxit domains verify --id DOMAIN_UUID

3. Create a receiving inbox

Wait for status active. Add an MX record for your dedicated subdomain pointing exclusively to mail.inboxit.wtf, priority 10, before assigning the custom address. Preserve unrelated root-domain mail records.

Example

inboxit inboxes create --name Support --idempotency-key support-001
inboxit inboxes list
inboxit inboxes address --id INBOX_UUID --address hello@mail.yourbrand.com

4. Send and observe

Use your recipient’s email address. New sends return a pending status. Check Logs or subscribe to webhooks to track delivery. Reuse an idempotency key only for the same logical message.

Example

inboxit emails send --from hello@mail.yourbrand.com --to recipient@example.com --subject Hello --text "Reply to this email." --idempotency-key welcome-001
inboxit logs list

5. Read the reply

Reply from the recipient mailbox. Use the mailbox UID returned by the list call to fetch the message. Register email.received to automate this step.

Example

inboxit messages list --id INBOX_UUID
inboxit messages get --id INBOX_UUID --message MESSAGE_UID