---
title: "ABots - Exchange Online - Mailbox Management - New Mailbox"
slug: "abots-microsoft-exchange-user-management-distribution-groups"
description: "Exchange Online Mailbox Management- New Mailbox ABot can automatically run mailbox creation processes in your Exchange Online."
updated: 2026-07-05T06:43:42Z
published: 2026-07-05T06:43:42Z
canonical: "documentation.sysaid.com/abots-microsoft-exchange-user-management-distribution-groups"
excludeFromSearch: true
excludeFromExternalSearch: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.sysaid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ABots - Exchange Online - Mailbox Management - New Mailbox

Once configured, the Exchange Online Mailbox Management- New Mailbox ABot can automatically run mailbox creation processes in your Exchange Online in response to workflow tickets opened in SysAid. This saves time and for both the IT admin and the employee who needs the update in Exchange Online.

Before you setup this ABot, ensure that your ABots platform is up and running. See the [SysAid ABot Guide](/v1/docs/abots-guide) for details.

![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/NewMailboxIcon.jpg)

## **Skills Included**

The Exchange Online Mailbox Management - New Mailbox ABot includes the following skills:

- **Create a user mailbox** - Creates a new user mailbox in Microsoft Exchange Online
- **Create a distribution group** - Creates a new distribution group in Microsoft Exchange Online

## **Import Skills**

1. On the main [My Apps](/v1/docs/my-apps) page, in the Exchange Online Mailbox Management- New Mailbox ABot's icon, click ![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/image-1654626506111.png).
2. Click the slider.
3. Click **Import ABot Skills**.  
 The skills are imported in the background.  
![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/ExchangeOnlineSetup.jpg)

## **Setup the Templates**

Each skill that you import includes a built-in template, ready to launch the automated process when a ticket is submitted. To set up the template you need to select values in all of the mandatory parameter mapping fields. Each skill has a different set of fields that are detailed below, but all require the relevant credentials. The credentials you select must have access to the machine that you want to run the automated process from and the machine must have access to all of the relevant agents. See the [ABot guide](/v1/docs/abots-guide) for information on how to prepare credentials so they can be selected in the parameter mapping for a skill. You also will want to ensure that the template is available in the Automation panel so that the skill can be run from within another ticket.

**To set up a template**

1. In **Settings > Service Desk Templates**, locate the new template. It will have the same name as the imported skill.  
![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/MailboxManagementTemplates.jpg)
2. Open the template.
3. In the Request Details tab, ensure that the **Visible in automation panel** check box is selected.  
![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/image-1654626593955.png)
4. In the Launch ABot workflow tab, click ![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/image-1654626609058.png).
5. Select the fields you want for parameter mapping. See the Parameter mapping section for explanations of each field and which fields are mandatory for each skill.  
![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/image-1654626621850.png)
6. Click **OK**.

## **Using the ABot**

Once the ABot skills have been imported, and the templates have been set up, admins and end-users can easily use the ABot's skills to initialize and automatically run the common tasks.

**To add an ABot process from any ticket**

1. In the ticket form, click **Automations**.
2. From the **Select an Automation Process** drop-down list, select the ABot skill you want to run.
3. Click **Launch**.![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/MailboxAutomationPanel.jpg)
4. In the window that opens, enter the information in the required fields.
5. Click **Apply**.

**To run an ABot using a template**

1. Open a new request form.
2. From the template drop-down, select the template for the ABot skill you want to run.
3. Enter the information in the required fields.
4. Click **Apply**.

You can access a record for each process run by ABots in Settings > Automate Joe > [Process Monitor](/v1/docs/process-monitor).

## **Parameter Mapping**

Each skill has it's own parameter mapping that needs to be set up in the workflow template that you want to run the skill. To set up the template, see the Setup the templates section above.

**For any of the parameters, follow the following steps:**

1. Select if you want the parameter to be populated from an SR field, an action item field, credential set, Automate Joe agent, group field, or a manual Velocity command.  
![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/image-1654626784523.png)
2. In the Set Value column, select a field, or type input with the variable name of the field you want to populate.
3. Select **Get Text** if you want to output the field value's caption instead of the its key.
4. Click **OK**.

To better understand the parameters for each skill, see the reference table below that details the mandatory parameters that must be populated for the ABot's skills.

**Create a New User Mailbox**

| **Parameter** | **Description** |
| --- | --- |
| **Required Parameters** |
| Execution Agent - Windows | The Windows agent that the ABot uses to run the process. |
| Execution Credentials - Windows | The credentials set to access the service on which you the ABot will execute the automated process. |
| Execution Agent - REST | The REST agent that the ABot uses to run the process. |
| Exchange online username | The name of the authentication user for the Exchange online server. |
| Exchange online password | The authentication user's password. |
| Mailbox name | The field that contained the name of the mailbox. |
| Microsoft online services ID | The field that contained the Microsoft online services ID. |
| Mailbox display name | The field that contained the mailbox display name. |
| Force change password 1/0 | Parameter that determines if users will be forced to change the password for the mailbox after initial login. |
| Shared mailbox 1/0 | Parameter that determines if the mailbox will be a shared mailbox or not. |
| **Output parameters** |
| Process exit code | Code that displays the result of the process run by the ABot. 0 - The process was successfully executed 1 - The process failed Select the field you where you want this information displayed. |
| Process last message | Message that states if the process was successful or not. Select the field you where you want this information displayed. |

**Create a New Distribution Group**

| **Parameter** | **Description** |
| --- | --- |
| **Required Parameters** |
| Execution Agent - Windows | The Windows agent that the ABot uses to run the process. |
| Execution Credentials - Windows | The credentials set to access the service on which you the ABot will execute the automated process. |
| Execution Agent - REST | The REST agent that the ABot uses to run the process. |
| Exchange online username | The name of the authentication user for the Exchange online server. |
| Exchange online password | The authentication user's password. |
| Distribution group name | The field that contains the name of the new distribution group. |
| Distribution group type | The type of group being created (e.g. "distribution"). |
| Distribution group display name | The field that contains the display name of the new distribution group. |
| Distribution group description | The field that contains the description of the new distribution group. |
| **Output parameters** |
| Process exit code | Code that displays the result of the process run by the ABot. 0 - The process was successfully executed 1 - The process failed Select the field you where you want this information displayed. |
| Process last message | Message that states if the process was successful or not. Select the field you where you want this information displayed. |

## **Other ABots**

For information about other available ABots, see any of the following help pages:

- [Active Directory - User Management - On\Offboarding](/v1/docs/abots-active-directory-user-management)
- [Active Directory - User Management - Groups and OU](/v1/docs/abots-active-directory-user-management-2)
- [Azure Active Directory - User Management - On\Offboarding](/v1/docs/abots-azure-user-management)
- [Azure Active Directory - User Management - Licensing](/v1/docs/abots-azure-ad-user-management-licensing)
- [Exchange Online - User Management - Groups](/v1/docs/abots-exchange-online-user-management-groups)
- [Microsoft Exchange - User Management - Distribution Groups](/v1/docs/abots-microsoft-exchange-user-management)
