Waymaker domains

Overview

Manage email domains for your organization. Configure custom domains, verify DNS settings, and manage domain routing.

Usage

waymaker domains <subcommand> [options]

Subcommands

Subcommand	Description
list	List configured domains
get	Get domain details
add	Add a new domain
verify	Verify domain DNS
remove	Remove a domain

List Domains

waymaker domains list

Output:

Email Domains (3)

domain              status      addresses   verified
----------------------------------------------------
company.com         active      25          ✓
sales.company.com   active      8           ✓
marketing.io        pending     0           ✗

JSON Output

waymaker domains list --json

[
  {
    "domain": "company.com",
    "status": "active",
    "verified": true,
    "address_count": 25,
    "created_at": "2026-01-01T00:00:00Z"
  }
]

Get Domain Details

waymaker domains get <domain>

Output:

company.com

Status: active
Verified: Yes
Addresses: 25
Added: January 1, 2026

DNS Records:
  MX Records:
    ✓ mx1.waymaker.com (Priority: 10)
    ✓ mx2.waymaker.com (Priority: 20)

  SPF Record:
    ✓ v=spf1 include:waymaker.com ~all

  DKIM Record:
    ✓ waymaker._domainkey.company.com

  DMARC Record:
    ✓ v=DMARC1; p=quarantine

Addresses:
  - info@company.com
  - support@company.com
  - sales@company.com
  ...

JSON Output

waymaker domains get company.com --json

Add Domain

waymaker domains add <domain>

Output:

✓ Domain added (pending verification)
Domain: marketing.io

Required DNS Records:

MX Records (add both):
  Host: @
  Type: MX
  Value: mx1.waymaker.com
  Priority: 10

  Host: @
  Type: MX
  Value: mx2.waymaker.com
  Priority: 20

SPF Record:
  Host: @
  Type: TXT
  Value: v=spf1 include:waymaker.com ~all

DKIM Record:
  Host: waymaker._domainkey
  Type: TXT
  Value: k=rsa; p=MIGfMA0GCSqGSIb3DQEB...

DMARC Record (recommended):
  Host: _dmarc
  Type: TXT
  Value: v=DMARC1; p=quarantine

Run 'waymaker domains verify marketing.io' after adding DNS records.

Verify Domain

waymaker domains verify <domain>

Output (success):

✓ Domain verified
Domain: marketing.io

All DNS records configured correctly:
  ✓ MX Records
  ✓ SPF Record
  ✓ DKIM Record
  ✓ DMARC Record

Domain is now active. You can create email addresses.

Output (pending):

⚠ Domain verification incomplete
Domain: marketing.io

DNS Status:
  ✓ MX Records - Configured
  ✗ SPF Record - Not found
  ✓ DKIM Record - Configured
  ✗ DMARC Record - Not found

Missing records need to be added to complete verification.
DNS changes may take up to 48 hours to propagate.

Force Re-check

waymaker domains verify marketing.io --force

Remove Domain

waymaker domains remove <domain>

Output:

⚠ Warning: Removing this domain will:
  - Disable 8 email addresses
  - Stop receiving email at this domain
  - Remove all domain DNS configuration

Are you sure? Use --confirm to proceed.

Confirm Removal

waymaker domains remove marketing.io --confirm

Output:

✓ Domain removed
Domain: marketing.io
Addresses disabled: 8

Options Reference

list

Option	Type	Description
--status	enum	Filter by status (active, pending, failed)
--json	flag	Output as JSON

get

Option	Type	Description
--json	flag	Output as JSON

add

Option	Type	Description
--skip-verification	flag	Add without immediate verification

verify

Option	Type	Description
--force	flag	Force DNS re-check
--json	flag	Output as JSON

remove

Option	Type	Description
--confirm	flag	Confirm removal without prompt

AI Agent Workflow

# List all domains
DOMAINS=$(waymaker domains list --json)

# Check domain status
PENDING=$(echo $DOMAINS | jq '.[] | select(.status == "pending")')

# Verify pending domains
for domain in $(echo $DOMAINS | jq -r '.[] | select(.verified == false) | .domain'); do
  waymaker domains verify $domain
done

# Add new domain for team
waymaker domains add "newteam.company.com"

# Check verification status
waymaker domains get "newteam.company.com" --json | jq '.dns_status'

Related Commands

• email - Email management
• email aliases - Bulk alias management for domain migrations
• shared-inboxes - Shared inbox management
• connections - Email connections