---
title: "Get Unread Exchange Emails"
slug: "get-unread-exchange-emails"
updated: 2025-09-02T19:32:13Z
published: 2025-09-02T19:32:13Z
canonical: "documentation.decisions.com/get-unread-exchange-emails"
---

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

# Get Unread Exchange Emails

| Step Details |
| --- |
| **Introduced in Version** | 4.0.0 |
| **Last Modified in Version** | 7.12.0 |
| **Location** | Integration > Exchange Web Services |

The **Get Unread Exchange Emails** step is used to retrieve unread exchange emails from a given Exchange server.

### Prerequisites

- This step requires the [Exchange Web Services module](https://documentation.decisions.com/docs/microsoft365-exchange) to be [installed](https://documentation.decisions.com/docs/installing-modules-decisions) before it will be available in the toolbox.
- A [dependency](https://documentation.decisions.com/docs/project-dependencies) must be created after installing the module in order for the Step to be properly used.

---

## Properties

#### Inputs

| Property | Description | Data Type |
| --- | --- | --- |
| Exchange Server | The server and authentication used. | Exchange Server Definition |
| Offset | Alters how far down the list the step begins pulling emails from. | Int32 |
| Page Size | Alters how many unread emails appear per page. | Int32 |

#### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| Output | Outputs list of unread exchange emails. | List of ExchangeEmail |

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1751999396031.png)

---

## Example Inputs and Outputs

| Exchange Server | Offset | Page Size | Output |
| --- | --- | --- | --- |
| (ExchangeServerSettings) | 0 | 3 | 0: Email 1 1: Email 2 2: Email 3 |
| (ExchangeServerSettings) | 2 | 5 | 0: Email 3 1: Email 4 2: Email 5 3: Email 6 4: Email 7 |

---

## Common Errors

### The Remote Server Returned an Error

If the remote server address is improperly entered, the step will cause an error.

To correct this, input a URL that is properly spelled to effectively connect to the designated server.

#### Error Message:

```csharp
DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Delete Exchange Calendar Item 1[DeleteExchangeCalendarItem] in flow [Step Library Flow]: Exception invoking method DeleteExchangeCalendarItem on class CalendarSteps
 ---> DecisionsFramework.LoggedException: Exception invoking method DeleteExchangeCalendarItem on class CalendarSteps
 ---> System.Exception: Delete Exchange Calendar Item error. ID: 24357865648936
 ---> System.AggregateException: One or more errors occurred. (The request failed. The remote server returned an error: (403) Forbidden.)
 ---> Microsoft.Exchange.WebServices.Data.ServiceRequestException: The request failed. The remote server returned an error: (403) Forbidden.
 ---> System.Net.WebException: The remote server returned an error: (403) Forbidden. at System.Net.HttpWebRequest.EndGetResponse(IAsyncResult asyncResult)
 at System.Threading.Tasks.TaskFactory`1.FromAsyncCoreLogic(IAsyncResult iar, Func`2 endFunction, Action`1 endAction, Task`1 promise, Boolean requiresSynchronization) --- End of stack trace from previous location --- at System.Net.WebRequest.GetResponseAsync()
 at Microsoft.Exchange.WebServices.Data.EwsHttpWebRequest.Microsoft.Exchange.WebServices.Data.IEwsHttpWebRequest.GetResponse()
 at Microsoft.Exchange.WebServices.Data.ServiceRequestBase.GetEwsHttpWebResponse(IEwsHttpWebRequest request)
   --- End of inner exception stack trace --- at Microsoft.Exchange.WebServices.Data.ServiceRequestBase.GetEwsHttpWebResponse(IEwsHttpWebRequest request)
 at Microsoft.Exchange.WebServices.Data.ServiceRequestBase.ValidateAndEmitRequest()
 at Microsoft.Exchange.WebServices.Data.SimpleServiceRequestBase.InternalExecuteAsync()
 at Microsoft.Exchange.WebServices.Data.MultiResponseServiceRequest`1.ExecuteAsync()
 at Microsoft.Exchange.WebServices.Data.ExchangeService.BindToItem(ItemId itemId, PropertySet propertySet)
 at Microsoft.Exchange.WebServices.Data.ExchangeService.BindToItem[TItem](ItemId itemId, PropertySet propertySet)
   --- End of inner exception stack trace --- at System.Threading.Tasks.Task.ThrowIfExceptional(Boolean includeTaskCanceledExceptions)
 at System.Threading.Tasks.Task`1.get_Result()
 at Decisions.Exchange.CalendarSteps.DeleteExchangeCalendarItem(ExchangeServerDefinition ExchangeServer, String CalendarItemId)
   --- End of inner exception stack trace --- at Decisions.Exchange.CalendarSteps.DeleteExchangeCalendarItem(ExchangeServerDefinition ExchangeServer, String CalendarItemId)
 at System.RuntimeMethodHandle.InvokeMethod(Object target, Void** arguments, Signature sig, Boolean isConstructor)
 at System.Reflection.MethodBaseInvoker.InvokeDirectByRefWithFewArgs(Object obj, Span`1 copyOfArgs, BindingFlags invokeAttr)
   --- End of inner exception stack trace ---
```

---

Related InformationRelated Articles:  
  
[Exchange Web Services Module](https://documentation.decisions.com/docs/microsoft365-exchange)