# Dynamic Mail

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/notifications/dynamic-mail/

_Requires Symcon >= 7.1_

Sends an e-mail with a dynamic text.

### Range of functions

* Sending an e-mail with a fixed/dynamic text
* Dynamic by replacing placeholders with the variable values

### Software installation

* Install the 'Dynamic e-mail' module via the Module Store.

### Setting up the instances in IP-Symcon

 Under 'Add instance', the 'Dynamic E-Mail' module can be found using the quick filter.
	- Further information on adding instances can be found in the [Instances documentation](https://www.symcon.de/service/dokumentation/konzepte/instanzen/#Instanz_hinzufügen)

__Configuration page__:

| Name            | Description                             |
| --------------- | --------------------------------------- |
| SMTP instance   | SMTP instance which is fully configured |
| Dynamic subject | Text input which can be set.            |
| Dynamic text    | Multi-line text input.                  |

The subject and the text are given a dynamic by inserting variable values. These can be set within the text by the variable ID placed in curly brackets. If the ID is too short or not a variable, the brackets with the number remain.

![Beispiel einrichtung](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/benachrichtigungen/dynamische-email/c0f01a2441-1790424938/beispiel-einrichtung.png)

__Action area__:

| Name                        | Description                                   |
| --------------------------- | --------------------------------------------- |
| Send Test                   | Sends an e-mail with the set subject and text |
| Preview e-mail with subject | A preview with set variable values            |
| Placeholder variables       | Table with the given placeholders             |

Table:
The placeholders found are listed in the table with their current value and status. If a placeholder is not available, the number entered is not an ID. If a placeholder is invalid, the ID found is not a variable.

### Status variables and profiles

No variables or profiles are created.

### Visualization

The instance has no functionality in the visualization.

## DM_SendMail

Source: https://www.symcon.de/en/service/documentation/module-reference/notifications/dynamic-mail/dm-sendmail/

`bool DM_SendMail(int $InstanceID)`

_Requires Symcon >= 7.1_

**Parameters**

- `$InstanceID` (int): ID of the instance

**Returns** (bool): If the command could be executed successfully, the result is __TRUE__, otherwise __FALSE__.

ID of the instance

**Example**

```php
DM_SendMail(12345);
```