Exchange Web Service icon

Exchange Web Service

Exchange Web Service API

Actions4

Overview

This n8n node interacts with Microsoft Exchange Web Services (EWS) to retrieve information about a specific item (such as an email, calendar event, or contact) using its unique Item ID. The "Get" operation for the "Item" resource is useful in scenarios where you need to fetch detailed data about a particular item stored in an Exchange mailbox. For example, you might use this node to:

  • Retrieve the full content of an email by its ID.
  • Fetch details of a calendar event for further processing.
  • Integrate Exchange item data into other workflows or systems.

Properties

Name Type Meaning
Authentication options Means of authenticating with the service. Only "NTLM" authentication is supported.
Item ID string The unique identifier of the item to retrieve from Exchange. Required.

Output

The output will be a JSON object containing the details of the requested Exchange item. The exact structure depends on the type of item retrieved (e.g., email, event, contact), but typically includes fields such as subject, body, sender, recipients, timestamps, and other metadata relevant to the item.

If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Dependencies

  • External Service: Microsoft Exchange Web Services (EWS) endpoint must be accessible.
  • Authentication: Requires valid EWS credentials configured in n8n under the credential type ewsApi (NTLM authentication).
  • n8n Configuration: Ensure that the EWS credentials are set up and tested within n8n.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the provided EWS credentials are incorrect or lack permissions, authentication will fail.
  • Incorrect Item ID: Supplying an invalid or non-existent Item ID will result in an error.
  • Network Issues: Connectivity problems between n8n and the EWS server can cause failures.

Error Messages:

  • "Settings are not valid or authentification failed: ..."
    This indicates a problem with the EWS credentials or authentication method. Double-check your credentials and ensure NTLM is supported/enabled on your Exchange server.
  • "No authentification method found"
    This means the selected authentication method is not implemented. Only "NTLM" is currently supported; ensure it is selected.

Links and References

Discussion