Skip to main content
Mailboxes are project-level email addresses that route inbound mail into rooms. They belong at the project level because the address belongs to the project, even though the work is delivered to a queue in a specific room. Use mailboxes when an agent listens on a mail: channel, or when you want inbound email to land in a queue that something in the room already consumes.

​
Create a mailbox

meshagent mailbox create \
  --address support@mail.meshagent.com \
  --room customer-support \
  --queue support-inbox
This creates a project mailbox and routes messages sent to support@mail.meshagent.com into the support-inbox queue in the customer-support room.

​
Inspect and manage mailboxes

meshagent mailbox list
meshagent mailbox show support@mail.meshagent.com
meshagent mailbox update support@mail.meshagent.com --queue escalations
meshagent mailbox delete support@mail.meshagent.com

​
Permissions

  • To create, update, or delete a mailbox for a room, you need permission to administer that room.
  • To list mailboxes across the whole project, you need developer access.

​
Where to manage mailboxes

  • Use MeshAgent Studio for the main UI flow.
  • Use the CLI when you want quick setup or scripting.
  • Use the REST API when you need programmatic mailbox management.