Tool

create_inbox

Create an inbox

SurfacesChat agentMCPCLI

Create ONE new inbox at a mailbox address (e.g. support@yourdomain.com). ORG-ADMIN ONLY and requires a human approval step in chat — the approval card shows the exact address and type before it's created. Use for the onboarding 'set up your first mailbox' step or when the operator asks to add a shared/personal inbox. Provide localPart (the bit before @); domain defaults to the deployment's sending domain. type 'shared' is a team inbox (support@, sales@), 'personal' is one person's. To create a SET of role addresses at once, tell the operator to use Settings → Inboxes presets (this tool creates one at a time).

CLI: tinbox create-inbox

Parameters

Name	Type	Required	Description
`localPart`	string	yes	The mailbox local-part — the bit before @ (e.g. 'support').
`domain`	string	no	Domain to use; defaults to the deployment's sending domain.
`name`	string	no	Display label; defaults to the capitalized local-part.
`type`	personalshared	no	'personal' (one human) or 'shared' (team inbox others can be granted onto). Default personal.

Example

json

{
  "localPart": "<localPart>"
}