Exchange Web Service icon

Exchange Web Service

Exchange Web Service API

Actions4

Item → Set Category

AI-generated

Overview

This n8n node allows you to set the category of an item (such as an email or calendar entry) in Microsoft Exchange via the Exchange Web Service (EWS) API. It is particularly useful for automating workflows that require organizing, tagging, or classifying items within an Exchange mailbox. For example, you could use this node to automatically categorize incoming emails based on their content or sender.

Practical examples:

  • Automatically assign a "To Review" category to all emails from a specific address.
  • Tag calendar events with a "Project X" category when they match certain criteria.
  • Integrate with other systems to update item categories based on external triggers.

Properties

Name Type Meaning
Authentication options Means of authenticating with the service. Only "NTLM" is supported.
Item ID string The unique identifier of the item (email, event, etc.) to categorize.
Category string The name of the category to assign to the specified item.

Output

The node outputs a JSON object reflecting the result of the category assignment operation. If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Example success output:

{
  "success": true,
  "itemId": "<ID of the item>",
  "category": "<Assigned category>"
}

Example error output (if continue on fail):

{
  "error": "Detailed error message"
}

Dependencies

  • External Service: Microsoft Exchange server with EWS enabled.
  • API Credentials: Requires valid EWS credentials configured in n8n under the "ewsApi" credential type.
  • Authentication Method: Only NTLM authentication is supported.
  • n8n Configuration: The node must be provided with the correct credentials and access rights to perform operations on the target Exchange account.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the EWS credentials are incorrect or lack sufficient permissions, authentication will fail.
  • Item Not Found: Providing an invalid or non-existent Item ID will result in an error.
  • Category Does Not Exist: Assigning a category that does not exist in the mailbox may cause the operation to fail, depending on Exchange configuration.

Error Messages:

  • "Settings are not valid or authentification failed: ..."
    Resolution: Check your EWS credentials and ensure NTLM authentication is correctly configured.
  • "No authentification method found"
    Resolution: Ensure the "Authentication" property is set to "NTLM".
  • "error": "<detailed error message>"
    Resolution: Review the error message for specifics; check item ID validity and category spelling.

Links and References

Discussion