Waymaker shared-inboxes

Overview

Manage shared email inboxes for team collaboration. Create shared addresses, manage access, and route incoming emails.

Usage

waymaker shared-inboxes <subcommand> [options]

Subcommands

Subcommand	Description
list	List shared inboxes
get	Get inbox details
create	Create a shared inbox
update	Update inbox settings
members	Manage inbox members
delete	Delete a shared inbox

List Shared Inboxes

waymaker shared-inboxes list

Output:

Shared Inboxes (4)

id           address                  members   unread   status
---------------------------------------------------------------
inbox_abc123 support@company.com      5         23       active
inbox_def456 sales@company.com        8         12       active
inbox_ghi789 info@company.com         3         45       active
inbox_jkl012 billing@company.com      2         5        active

JSON Output

waymaker shared-inboxes list --json

[
  {
    "id": "inbox_abc123",
    "address": "support@company.com",
    "name": "Support Inbox",
    "member_count": 5,
    "unread_count": 23,
    "status": "active",
    "created_at": "2026-01-01T00:00:00Z"
  }
]

Get Inbox Details

waymaker shared-inboxes get <inbox-id>

Output:

Support Inbox

ID: inbox_abc123
Address: support@company.com
Status: active
Created: January 1, 2026

Statistics:
  Unread: 23
  Today: 15 received, 8 sent
  This Week: 89 received, 45 sent
  Avg Response Time: 2.5 hours

Members: (5)
  - john@company.com (admin)
  - jane@company.com (member)
  - bob@company.com (member)
  - alice@company.com (member)
  - charlie@company.com (member)

Settings:
  Auto-assign: Round robin
  Business hours: 9am - 5pm EST
  Auto-reply: Enabled

JSON Output

waymaker shared-inboxes get inbox_abc123 --json

Create Shared Inbox

waymaker shared-inboxes create \
  --address "support@company.com" \
  --name "Support Inbox"

Output:

✓ Shared inbox created
ID: inbox_new123
Address: support@company.com
Name: Support Inbox

Create with Members

waymaker shared-inboxes create \
  --address "sales@company.com" \
  --name "Sales Team Inbox" \
  --members user_abc123,user_def456

Create with Settings

waymaker shared-inboxes create \
  --address "info@company.com" \
  --name "General Inquiries" \
  --auto-assign round-robin \
  --auto-reply "Thanks for contacting us. We'll respond within 24 hours."

Update Inbox Settings

waymaker shared-inboxes update <inbox-id> \
  --name "Updated Name" \
  --auto-assign load-balanced

Update Auto-Reply

waymaker shared-inboxes update inbox_abc123 \
  --auto-reply "Thank you for your email. Our team will respond shortly."

Disable Auto-Reply

waymaker shared-inboxes update inbox_abc123 --auto-reply ""

Set Business Hours

waymaker shared-inboxes update inbox_abc123 \
  --business-hours "09:00-17:00" \
  --timezone "America/New_York"

Manage Members

List Members

waymaker shared-inboxes members <inbox-id> list

Output:

Inbox Members: support@company.com (5)

id           email                role      added
-------------------------------------------------
user_abc123  john@company.com     admin     Jan 2026
user_def456  jane@company.com     member    Jan 2026
user_ghi789  bob@company.com      member    Jan 2026

Add Member

waymaker shared-inboxes members <inbox-id> add \
  --user <user-id> \
  --role member

Remove Member

waymaker shared-inboxes members <inbox-id> remove --user <user-id>

Change Role

waymaker shared-inboxes members <inbox-id> role \
  --user <user-id> \
  --role admin

Delete Shared Inbox

waymaker shared-inboxes delete <inbox-id>

Output:

⚠ Warning: Deleting this inbox will:
  - Stop receiving emails at support@company.com
  - Archive all existing conversations
  - Remove member access

Use --confirm to proceed.

waymaker shared-inboxes delete inbox_abc123 --confirm

Options Reference

list

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

get

Option	Type	Description
--json	flag	Output as JSON

create

Option	Type	Description
--address	string	Required. Email address
--name	string	Required. Inbox display name
--members	string	Comma-separated user IDs
--auto-assign	enum	Assignment mode (none, round-robin, load-balanced)
--auto-reply	string	Auto-reply message

update

Option	Type	Description
--name	string	New inbox name
--auto-assign	enum	Assignment mode
--auto-reply	string	Auto-reply message (empty to disable)
--business-hours	string	Business hours (HH:MM-HH:MM)
--timezone	string	Timezone for business hours
--status	enum	Inbox status (active, paused)

members

Option	Type	Description
--user	string	User ID
--role	enum	Member role (admin, member)
--json	flag	Output as JSON

delete

Option	Type	Description
--confirm	flag	Confirm deletion

AI Agent Workflow

# List all shared inboxes
INBOXES=$(waymaker shared-inboxes list --json)

# Find inbox with most unread
BUSIEST=$(echo $INBOXES | jq 'max_by(.unread_count)')
echo "Busiest inbox: $(echo $BUSIEST | jq -r '.address') with $(echo $BUSIEST | jq '.unread_count') unread"

# Get inbox statistics
waymaker shared-inboxes get inbox_abc123 --json | jq '.statistics'

# Add new team member to support
waymaker shared-inboxes members inbox_abc123 add \
  --user $NEW_HIRE_ID \
  --role member

# Create inbox for new project
waymaker shared-inboxes create \
  --address "project-alpha@company.com" \
  --name "Project Alpha Team" \
  --members "$PROJECT_TEAM_IDS" \
  --auto-assign round-robin

Related Commands

• email - Email management
• domains - Domain management
• users - User management
• teams - Team management