---
title: "Email Calendar File"
slug: "email-calendar-file"
tags: ["calendar", "files", "ics", "ical", "email"]
updated: 2023-09-21T10:48:39Z
published: 2023-09-21T10:48:39Z
canonical: "documentation.decisions.com/email-calendar-file"
---

> ## 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.

# Email Calendar File

| ## Step Details |
| --- |
| **Introduced in Version** | 4.0.0 |
| **Last Modified in Version** | 7.1.0 |
| **Location** | Integration > ICAL |

The **Email Calendar File** step allows users to send the iCal file type to the specified email address.

---

## Properties

#### Email

| Properties | Description | Data Type |
| --- | --- | --- |
| From | The email address of the sender | String |
| To | Denotes the email's recipient(s) | List of String |
| High Priority | Flags the email as high priority | Boolean |
| Subject | Provides the email's Subject line | String |
| Body | The Body content of the email. The Merge Plain Text mapping can be used to combine Flow Data with user-input text to make up the body. | String |
| Attachments | Used to attach files to the email | List of FileData |

#### Email - Addressing

| Property | Description | Data Type |
| --- | --- | --- |
| Reply To | The email address that receives the response in the event of an email reply | String |
| CC | Denotes the recipient of a Carbon Copy of the email | String |
| BCC | Denotes a recipient of the email's Carbon Copy but hides the address of the recipient | String |

#### Email Retry

| Properties | Description | Data Type |
| --- | --- | --- |
|  | Show Fail on Path | Provides the "On Error" outcome path | Boolean |
|  | Retry on Fail | Resends the email in the event of failure | Boolean |
|  |  | Retry Count | Limits how many times the step tries to retry sending the email in the event of a failure; the default value is "3" | Int32 |
|  |  | Retry Delay in Seconds | Dictates how long to wait before retrying the Send Email process | Int32 |

#### Settings - Contents

| Properties | Description | Data Type |
| --- | --- | --- |
| Clean Up HTML | Converts HTML containing " &" to their standard characters | Boolean |
| Send Raw HTML | Formats as raw HTML | Boolean |
| Email Content Type | Select formatting for the email; selecting Auto auto-selects an option, HTML sends the email in HTML format, and Plain sends the email as plain text. | --- |
| Pick Email Template | Enables selection of pre-existing [Email Templates](https://documentation.decisions.com/v8/docs/email-templates) via the Email Template dropdown | Boolean |
| Email Template | Displays a dropdown of pre-existing Email Templates | --- |

#### SMTP Settings

| Properties | Description | Data Type |
| --- | --- | --- |
|  | Use Default SMTP Settings | Uses the server's default [SMTP Settings](https://documentation.decisions.com/docs/email-and-smtp-in-decisions); these are typically set up at installation. | Boolean |
|  |  | SMTP Server Settings | Provides dialog to establish SMTP Settings for the step to use (i.e., Server Address, Client Domain, etc.) | --- |

#### Inputs

| Property | Description | Data Type |
| --- | --- | --- |
| iCal File | The desired iCal file | String |

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

---

## Common Errors

### Object reference not set to an instance of an object

If the iCal File is null or empty, the step will cause an error. To correct this, ensure that an ics file is mapped or uploaded to the iCal File field.

#### Exception Message:

```csharp
Exception Stack Trace: DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Email Calendar File 1[SendICalFileInEmail] in flow [Flow 3]: Object reference not set to an instance of an object.
 ---> System.NullReferenceException: Object reference not set to an instance of an object. 
at Decisions.ICal.CalendarHelper.SetupCalendarAttachment(MailMessage email, FileData icsFile
 at Decisions.ICal.SendICalFileInEmail.CreateEmail(StepStartData data
 at DecisionsFramework.Design.Flow.CoreSteps.SendEmailStep.Run(StepStartData data
 at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData
 at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData)
   --- End of inner exception stack trace ---
```

## Related

- [Get Week of Year by Calendar Type](/get-week-of-year-by-calendar-type.md)
- [Cancel Event](/cancel-event.md)
- [Create Event](/create-event.md)
- [Get Event From File_ New](/get-event-from-file-new.md)
- [Email Appointment Cancellation](/email-appointment-cancellation.md)
- [Email Appointment Invite](/email-appointment-invite.md)