---
title: "Set-EmailMessage"
slug: "scripting-set-emailmessage"
updated: 2025-07-16T20:24:17Z
published: 2025-07-16T20:24:17Z
canonical: "help.agilityblue.com/scripting-set-emailmessage"
---

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

# Set-EmailMessage

## Summary

Updates an existing email message.

```powershell
Set-EmailMessage
    -Entry
```

Returns a [email message](https://apidocs.agilityblue.com/#47ed2fff-291a-4746-bc0c-6f88212e6c99) object.

## Parameters

| Parameter | Type | Required? | Notes |
| --- | --- | --- | --- |
| Entry | [Email message](https://apidocs.agilityblue.com/#47ed2fff-291a-4746-bc0c-6f88212e6c99) object | Yes | The email message object to update for an existing entry. |

## Examples

### Updates an existing email message

```powershell
# Retrieve an existing email message using the Get-EmailMessage cmdlet
$emailMessage = Get-EmailMessage -Id 59

# Change some properties
# In this example, we want to update the body and add a signature block at the bottom
$emailMessage.Body = "$($emailMessage.Body)<p>Best Regards,<br />Litigation Support Department</p>"

# Update the email message using the Set-EmailMessage cmdlet
$updatedEmailMessage = Set-EmailMessage -Entry $emailMessage

# Output a message to the execution log
Write-Output "Updated email message $($updatedEmailMessage.EmailMessageId) ($($updatedEmailMessage.Subject))"
```

Execution results:

```plaintext
Updated email message 59 (Email was created from a script)
```