SSEO - Failed to add category to email

Overview

Some users may encounter an issue with the Outlook Add-in where the installation process attempts to create a category titled "Logged to NetSuite", but the category either fails to be created in the user’s mailbox or is not available in the mailbox where the email is being logged.

This commonly occurs when the category exists in an individual inbox but is not available in a shared inbox, or when the category creation step fails during installation.

As a result, when users attempt to log an email, the Add-in cannot apply the required category and returns the following error:

"Failed to add category to email."

This issue can occur in any version of Outlook, but it is most commonly observed in the New Outlook experience and in shared inbox scenarios.

Issue Description

The issue is caused by how Outlook manages categories at the mailbox level.

During installation, the Add-in attempts to create the "Logged to NetSuite" category in the user’s mailbox. If this step fails, the category does not exist and cannot be applied during the logging process.

In other cases, the category is successfully created in an individual inbox but is not available in another mailbox, such as a shared inbox, because:

• Outlook categories are stored at the mailbox level and are not shared across mailboxes
• Each mailbox must have its own copy of the category to use it
• In the New Outlook, category handling for shared mailboxes is more limited, making this issue more common

Because the category is not available in the mailbox where the email is being logged, the email logs successfully, but the category is not applied and an error is shown.

Suggested Resolution

To resolve the issue, manually create the missing category in the affected mailbox.

Steps:

1. Go to the Affected Inbox
   Open Outlook and navigate to the inbox where the issue is occurring.

2. Select a Message
   Click on any message to enable the message toolbar.

3. Open Category Management
   Click Categorize from the toolbar.
   Select Manage Categories or All Categories, depending on your Outlook version.

4. Create the Category
   Click New.
   Enter the name exactly as: "Logged to NetSuite" (case-sensitive).
   Save the category.

5. Confirm Category Availability
   Ensure the category now appears as an option when categorizing messages.

Additional Notes

• The issue is caused by the category not being created or not existing in the correct mailbox
• Emails log successfully even when the error is shown
• Each mailbox requires its own version of the category
• This can occur in any Outlook version, but is most common in New Outlook and shared mailbox scenarios due to category handling limitations