| Step Details | |
| Introduced in Version | 4.0.0 |
| Last Modified in Version | 9.10.0 |
| Location | Integration > Microsoft365 > Exchange > Contacts |
The Get Contact step retrieves an existing contact for a connected Microsoft365 Exchange account.
Prerequisites
- This step requires the Microsoft 365 Exchange module to be installed before it will be available in the toolbox.
- A dependency must be created after installing the module in order for the the steps to be properly used.
Properties
Inputs
| Property | Description | Data Type |
|---|---|---|
| Child Folder Id | ID of the child folder to get the contact from. | String |
| Contact Folder Id | ID of the contact folder holding the inputted child folder. | String |
| Contact Id | ID of the contact to retrieve. | String |
| Expand Query | Permits the extension of what the designated query is to be. | String |
| User Identifer | Identifier of the user to associate with the retrieval of the Contact. | String |
Settings
| Property | Description | Data Type |
|---|---|---|
| Settings Override | Optional settings to override default OAuth token. | InputExchangeSettings |
Outputs
| Property | Description | Data Type |
|---|---|---|
| Output | Outputs completed step information and retrieved Contact. | Microsoft365Contact |
Common Errors
The Request Was Unsuccessful.
If the token defined cannot be used to access Microsoft Exchange, the step will cause an error.
To correct this, ensure a correct and valid OAuth token has been established.
Exception Message:
DecisionsFramework.BusinessRuleException: [BusinessRule] The request was unsuccessful. ---> System.Net.Http.HttpRequestException: Response status code does not indicate success: 401 (Unauthorized).
at System.Net.Http.HttpResponseMessage.EnsureSuccessStatusCode()
at Decisions.Microsoft365.Exchange.GraphRest.SendHttpRequest(ExchangeSettings settingsOverride, String url, HttpContent content, HttpMethod httpMethod)
--- End of inner exception stack trace ---
at Decisions.Microsoft365.Exchange.GraphRest.SendHttpRequest(ExchangeSettings settingsOverride, String url, HttpContent content, HttpMethod httpMethod)
at Decisions.Microsoft365.Exchange.GraphRest.CreateHttpRequest(ExchangeSettings settingsOverride, String urlExtension, HttpContent content, HttpMethod httpMethod)
at Decisions.Microsoft365.Exchange.GraphRest.HttpResponsePost(ExchangeSettings settingsOverride, String urlExtension, HttpContent content)
at Decisions.Microsoft365.Exchange.GraphRest.Post(ExchangeSettings settingsOverride, String urlExtension, HttpContent content)
at Decisions.Microsoft365.Exchange.Steps.ExchangeCalenderSteps.CreateCalendarEvent(Microsoft365CalendarEvent microsoft365CalendarEvent, String userIdentifier, String calendarId, InputExchangeSettings settingsOverride)
at System.RuntimeMethodHandle.InvokeMethod(Object target, Void** arguments, Signature sig, Boolean isConstructor)
at System.Reflection.MethodBaseInvoker.InvokeDirectByRefWithFewArgs(Object obj, Span`1 copyOfArgs, BindingFlags invokeAttr)Related Information
Related Articles:
Exchange Web Services Module