Team Email

Teams on Professional and Business plans can provision a dedicated team mailbox with IMAP/SMTP access. This gives your team a {tenantId}@users.osaas.io email address that can be used with any standard email client.

Prerequisites

  • An account with a Professional or Business plan
  • Tenant admin role (to manage the mailbox)

Creating Your Team Mailbox

Step 1: Navigate to Team Settings

From the dashboard, click on your team name in the top navigation, then select Team Settings.

Step 2: Go to the Mail Tab

In the left sidebar of Team Settings, click on Mail.

Step 3: Create Mailbox

On the Mail page, you'll see a form to create your team mailbox.

  1. Enter a password (minimum 12 characters)
  2. Confirm the password
  3. Click Create Mailbox

The mailbox will be created with the email address {tenantId}@users.osaas.io, where {tenantId} is your unique tenant identifier.

Step 4: Configure Your Email Client

Once created, you'll see the connection details for SMTP and IMAP:

SMTP (Outgoing Mail) - Server: mail.svc.prod.osaas.io - Port: 587 - Encryption: STARTTLS

IMAP (Incoming Mail) - Server: mail.svc.prod.osaas.io - Port: 143 - Encryption: STARTTLS

Use your team's email address ({tenantId}@users.osaas.io) and the password you set to configure your email client (Thunderbird, Apple Mail, Outlook, etc.).

Managing Your Mailbox

Changing the Password

You can change your mailbox password at any time:

  1. Go to Team Settings > Mail
  2. Click Change Password
  3. Enter your new password (minimum 12 characters)
  4. Confirm the password
  5. Click Update Password

Note: Password changes are rate-limited to 5 changes per hour.

Deleting Your Mailbox

To remove your team mailbox:

  1. Go to Team Settings > Mail
  2. Click Delete Mailbox
  3. Confirm the deletion

Warning: This action is permanent and cannot be undone. All emails and data will be lost.

Using the OSC CLI

You can also manage your team mailbox using the OSC CLI:

Check mailbox status

npx -y @osaas/cli mail status

Create a mailbox

npx -y @osaas/cli mail create --password "your-secure-password"

Change password

npx -y @osaas/cli mail change-password --password "new-secure-password"

Delete mailbox

npx -y @osaas/cli mail delete

Using with AI Agents

If you have OSC connected to AI agents via MCP, you can ask your AI assistant to manage your mailbox using natural language:

  • "Check if I have a team mailbox"
  • "Create a team mailbox with a secure password"
  • "Change my mailbox password to something more secure"
  • "Delete my team mailbox"
  • "Show me my SMTP and IMAP connection details"

The AI agent will use the following MCP tools to interact with the mail provisioning API on your behalf:

  • get-mail-status - Check mailbox status and get connection details
  • create-mailbox - Create a new team mailbox (requires paid plan)
  • change-mail-password - Update mailbox password
  • delete-mailbox - Remove team mailbox

Note: Creating a mailbox requires a Professional or Business plan. If you're on the free tier, the AI agent will suggest upgrading your plan.

Troubleshooting

Cannot create mailbox

  • Verify you're on a Professional or Business plan
  • Ensure you have tenant admin permissions
  • Check that you don't already have a mailbox (only one per team)

Email client connection issues

  • Verify you're using the correct server addresses and ports
  • Ensure STARTTLS is enabled in your email client
  • Double-check your password is correct
  • Try using port 993 for IMAP with SSL/TLS instead of STARTTLS

Password change rate limit

  • You can change your password up to 5 times per hour
  • If you hit the limit, wait an hour before trying again

Need Help?

If you need assistance with team email provisioning, contact support at contact@support.osaas.io