Automations - Actions
Package: BASIC
1. Action configuration
Actions determine what should happen when an event occurs and any prerequisites are met.
For each action, the user to be used for execution can be defined.
After clicking an action in the editor, the "Action" sidebar opens.
Action sidebar
An action can only be configured if it is connected to an already configured trigger or an already configured condition!
After a double-click on an action in the editor – alternatively via the "Edit" action in the action sidebar – the "Action" popup opens.
In the "Action" popup, all available actions are displayed as tiles (including a short description). To find a desired action more quickly, the popup is divided into three tabs:
- All → Display of all available actions
- Record-related → Display of record-related actions
- Messages → Display of actions that send messages or display information
Action popup - "All" tab
Action popup - "Record-related" tab
Action popup - "Messages" tab
The following actions are available (each depending on the selected trigger):
| Action | Description | available for trigger |
|---|---|---|
| Attachments as document | Creates attachments of a scanned email as documents, taking conditions into account. |
|
| Send notification | Sends personalised notifications with information from the main record. |
|
| Update record | Updates fields from the main record or records linked via reference fields. |
|
| Create record | Creates a new record. |
|
| Delete record | Allows deletion of the triggering record. Additionally, links of the record can also be deleted along with it. |
|
| Delete record | Deletes records from the selected modules that were created by Billing item actions. |
|
| Link records | Searches subject and content for record numbers and links the email. Includes the "Save email" action. |
|
| Send email | Sends personalised emails with information from the main record as well as linked records. |
|
| Save email | Stores a scanned email as a copy in the system and links it to further records if applicable. |
|
| Show information | Displays information to the logged-in user that can originate from the main record and its links.
The information can be displayed as a note or as a popup dialog (configurable in the action). |
|
| Edit item | Allows editing of items in Billing modules. |
|
| Add item | Allows creation of new items in Billing modules. |
|
| Create/update ticket | Updates tickets based on record numbers or creates new ones if not found, with optional creation of the sender. |
|
| Default interest | Inserts an item to cover default interest. |
|
| Contract update | Updates the items of a contract, based on a sales order. |
|
| Call webhook | Allows the transfer of fields, items or relations of a record to a webhook via a POST or GET call. |
|
| Item-based calculations | Calculates values based on items and writes them into a main field of the record. Supports filtering by conditions. |
|
| Update relations | Updates the relations of the triggering record. Relations to be updated can be restricted by conditions. |
|
| Request payment mandate | Requests a mandate via the configured payment provider. Only available if a payment provider is configured and activated for the client. |
|
| Payment collection | Triggers a payment collection via the configured payment provider. Prerequisites: A payment provider is activated for the client, the invoice originates from a contract with a valid mandate. The action requires no further configuration apart from naming. |
|
| Send SMS | Sends an SMS via the telephone integration of the logged-in user |
|
1.1. Action step 1 - Selecting the action
By marking (clicking) an action in the "Action" popup and clicking the "Next" button, a popup opens in which the selected action is configured in detail.
1.2. Action step 2 - Configure action
1.2.1. Attachments as document
The "Attachments as document" action creates attachments of a scanned email as documents, taking conditions into account.
Attachments as document popup
The following fields/functions are available in the "Attachments as document" popup:
- Attachment
- Responsible for created records * → Selection of the responsible user/group
- Client for created records * → Selection of the client for the created records
- Directory * → Selection of the directory in which the record is stored
- Prefix for title → Configuration of the prefix for the title:
- none (file name only)
- Subject
- Sender address
- Free text
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
*Mandatory field
After clicking the "Save" button in the "Attachments as document" popup, the action is saved and displayed in the editor.
1.2.2. Send notification
The "Send notification" action sends personalised notifications with information from the main record as well as linked records.
Send notification popup
The following fields/functions are available in the "Send notifications" popup:
- Notification
- To → Selection of users, groups, roles and user fields of the triggering record by clicking the action icon "Add recipient" (icon "Plus") that should receive the notification
- Subject → Input field for the subject of the notification
Note: Placeholders can be inserted in the subject of the message. - Editor → A formattable message text can be entered in the editor area
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Frequency
* → picklist for when a notification should be sent:
- every time → the notification is sent every time the trigger and the condition apply
- once → the notification is sent only once per record when the trigger and the condition apply
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
- Repetition (only available if the value "every time" was selected in the "Frequency" field) → After clicking the "Configure repetition" button, a popup opens with the following fields:
- Input field "Every" → Input field for the duration of the delay of the selected time unit
- picklist "Time unit" → picklist with the time units day(s)/week(s)/month(s)/year(s)
Repeated actions are stopped as soon as the conditions no longer apply at the time the trigger is executed.
- Frequency
* → picklist for when a notification should be sent:
*Mandatory field
Send notification popup - Configure delay
Send notification popup - Configure repetition
After clicking the "Save" button in the "Send notifications" popup, the action is saved and displayed in the editor.
1.2.3. Update record
The "Update record" action updates fields from the main record or records linked via reference fields.
Update record popup
The following fields/functions are available in the "Update record" popup:
- Button "Add field" → a picklist of all available fields for updating is displayed.
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Frequency
* → picklist for when a record should be updated:
- every time → the record is updated every time the trigger and the condition apply
- once → the record is updated every time the trigger and the condition apply
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
- Repetition (only available if the value "every time" was selected in the "Frequency" field) → After clicking the "Configure repetition" button, a popup opens with the following fields:
- Input field "Every" → Input field for the duration of the delay of the selected time unit
- picklist "Time unit" → picklist with the time units day(s)/week(s)/month(s)/year(s)
Repeated actions are stopped as soon as the conditions no longer apply at the time the trigger is executed.
- Frequency
* → picklist for when a record should be updated:
*Mandatory field
1.2.3.1. Step 1 - Update record - Add field
After clicking the "Add field" button, a picklist of all available fields for updating is displayed.
After selecting the field, it is displayed as a new row.
Update record popup - Add field
The new value of the field can now be entered in the input field.
In the row of an input field, two action icons are often also displayed:
- Action icon "Configure workspace" (icon "Puzzle") → displays the Set value popup to generate more complex field values
- Action icon "Remove field" (icon "Trash") → deletes the field
1.2.3.2. Step 1a - Update record - Configure workspace (optional)
Optionally, the "Configure workspace" function can also be used to configure more complex comparisons.
After clicking the action icon "Configure workspace" (icon "Puzzle"), the "Set value" popup opens.
The functionalities in the "Set value" popup are described in detail in the section Configure workspace - Set value.
1.2.4. Create record
The "Create record" action creates new records in other modules.
Create record popup
The following fields/functions are available in the "Create record" popup:
- picklist "Object type" * → picklist of object types (modules) for which a new record should be created.
- Button "Add field" → a picklist of all available fields of the selected object type (module) is displayed.
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Frequency
* → picklist for when a record should be updated:
- every time → the record is updated every time the trigger and the condition apply
- once → the record is updated every time the trigger and the condition apply
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
- Repetition (only available if the value "every time" was selected in the "Frequency" field) → After clicking the "Configure repetition" button, a popup opens with the following fields:
- Input field "Every" → Input field for the duration of the delay of the selected time unit
- picklist "Time unit" → picklist with the time units day(s)/week(s)/month(s)/year(s)
Repeated actions are stopped as soon as the conditions no longer apply at the time the trigger is executed.
- Frequency
* → picklist for when a record should be updated:
*Mandatory field
1.2.4.1. Step 1 - Create record - Select object type
- picklist "Object type" → After clicking the "Object type" picklist, a picklist of all available modules is displayed in which a new record can be created.
- picklist "Reference field" → After clicking the "Reference field" picklist, a picklist of the modules is displayed through which a link to the source record is established.
- picklist "Action" → Selection of the action used as the basis for the data transfer.
Depending on the selected object type (module), further fields for configuration are displayed.
Create record popup - Object type Contracts
Create record popup - Object type Documents
For many fields the "i" icon
![]()
is available, which displays additional information about the respective field on mouseover.
Mandatory fields are marked with a red asterisk *.
In the row of an input field, two action icons are often also displayed:
- Action icon "Configure workspace" (icon "Puzzle") → displays the Set value popup to generate more complex field values
- Action icon "Remove field" (icon "Trash") → deletes the field
1.2.4.2. Step 1a - Create record - Configure workspace (optional)
Optionally, the "Configure workspace" function can also be used to configure more complex comparisons.
After clicking the action icon "Configure workspace" (icon "Puzzle"), the "Set value" popup opens.
The functionalities in the "Set value" popup are described in detail in the section Configure workspace - Set value.
1.2.5. Delete record
The "Delete record" action allows deletion of the triggering record. Additionally, links of the record can also be deleted. Deleted records are moved to the Recycle Bin module.
Delete record popup
The following fields/functions are available in the "Delete record" popup:
- Delete link from (optional) → picklist of modules that may have a reference to the record to be deleted. The reference is also deleted when the triggering record is deleted. One or more modules can be selected.
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Delay
* → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
- Delay
* → after clicking the "Configure delay" button, a popup opens with the following fields:
*Mandatory field
1.2.5.1. Step 1 - Delete record - Configure delay
For a smooth process, this action must be executed with a delay. To achieve the fastest possible execution, a delay before the trigger time can be configured, for example.
1.2.5.2. Step 1a - Delete record - Delete links (optional)
In the "Delete link from" field (picklist), modules can be selected that may have a reference to the record to be deleted. The reference is also deleted when the triggering record is deleted. One or more modules can be selected.
After clicking the "Save" button in the "Delete record" popup, the action is saved and displayed in the editor.
1.2.6. Delete record
The "Delete record" action deletes records from the selected modules that were created by Billing item actions.
Delete record popup
The following fields/functions are available in the "Delete record" popup:
- Modules to be deleted * → picklist of modules in which records created by Billing item actions should be deleted. One or more module(s) can be selected.
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
*Mandatory field
After clicking the "Save" button in the "Delete record" popup, the action is saved and displayed in the editor.
1.2.7. Link records
The "Link records" action searches subject and content for record numbers and links the email. Includes the Save email action.
Link records popup
The following fields/functions are available in the "Delete record" popup:
- Link to * → picklist of modules to which the email should be linked. One or more module(s) can be selected.
- Restrict number ranges → Restriction of number ranges to be searched per module. If no restriction is selected for a module, all number ranges are searched. X = currently inactive number range.
- Search content in addition to subject → Switch for configuring whether the content should be searched in addition to the subject.
- Save email → If records for linking are identified, but the email is not yet in the system, it is created once with this configuration.
- Link to
* → picklist for configuring which address the email should be linked to (both addresses can be selected):
- Sender address
- Recipient addresses
- Use blacklist from email account → Switch for configuring whether the blacklist from the email account should be used.
- Responsible for email → Selection of the responsible user/group
- Client for created records * → Selection of the client for the created records
- Create if address not found → picklist for configuring whether a new record should be created if the address is not found. The following values are available for selection:
- no
- as contact
- as lead
- Link to
* → picklist for configuring which address the email should be linked to (both addresses can be selected):
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
*Mandatory field
After clicking the "Save" button in the "Link records" popup, the action is saved and displayed in the editor.
1.2.8. Send email
The "Send email" action sends personalised emails with information from the main record as well as linked records.
Send email popup
For the "Send email" action, the responsibility for the sent email can be defined. The default value for responsibility is the executing user.
The following fields/functions are available in the "Send email" popup:
- Field "From" → Selection of the sender email account
- Action icon "Change sender email account" → After clicking the action icon, a picklist of all email accounts opens for which the "Automation allowed" setting is set to "active".
- Field "To" → Selection of the email recipients
- Action icon "CC" → Displays the input row for CC recipients
- Action icon "BCC" → Displays the input row for BCC recipients
- Action icon "Add recipient" (icon "Plus") → Opens a picklist of email fields from the modules. One or more fields can be selected; direct entry of an email address is also possible.
- Editor → The text of the email is composed in the editor area. Optionally, an email template can be selected and an attachment added.
-
Action button "Template" → After clicking the action button, a flyout menu opens for selecting an email template. Additionally, two further actions are available:
- Create template → In a new browser tab, the creation view of an email template is opened to create a new template.
- Update templates → The list of available email templates is updated.
-
Action icon "Add attachment" (icon "Paperclip") → After clicking the action icon, a flyout menu opens with the actions:
- PDF template → Opens the "Load template" popup window for selecting a PDF template.
- File field → Opens the "Select field" popup window in which a file field from a module can be selected via a picklist.
- Select file → The file explorer of the operating system opens to select files.
-
Editor area/email body → In the email body, the text can be formatted using the toolbar. The toolbar offers all functionalities for text formatting (e.g. font and size, lists, inserting images and links, tables, etc.).
On mouseover of the "Email body" area, the "Keyboard shortcut" icon (opens the "Keyboard shortcuts" popup) is displayed at the bottom right.
-
- Field "Responsible for created records" * → picklist of users/groups for the "responsible" field in created records
- Field "Priority" → picklist of the priority of the email (values Low, Normal and High)
- Switch "Save email in CRM" → Setting for whether the email should be saved in the CRM (Emails module)
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Execute as * → picklist for which user (logged-in user or username) the action is executed as
- Frequency
* → picklist for when an email should be sent:
- every time → the record is updated every time the trigger and the condition apply
- once → the record is updated every time the trigger and the condition apply
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
- Repetition (only available if the value "every time" was selected in the "Frequency" field) → After clicking the "Configure repetition" button, a popup opens with the following fields:
- Input field "Every" → Input field for the duration of the delay of the selected time unit
- picklist "Time unit" → picklist with the time units day(s)/week(s)/month(s)/year(s)
Repeated actions are stopped as soon as the conditions no longer apply at the time the trigger is executed.
*Mandatory field
1.2.8.1. Step 1 - Send email - Sender email account
After clicking the action icon "Change sender email account" (icon "Inbox"), a picklist of all email accounts opens for which the "Automation allowed" setting is set to "active".
1.2.8.2. Step 2 - Send email - Select recipients
After clicking the action icon "Add recipient" (icon "Plus"), a picklist of email fields from the modules opens.
One or more fields can be selected; direct entry of an email address is also possible (by pressing the Enter key, the entered email address is transferred to the recipient field).
Send email popup - picklist for the "To" field
1.2.8.3. Step 3 - Send email - Subject
The subject of the email is entered in the input row.
1.2.8.4. Step 4 - Send email - Select template (optional)
After clicking the action button, a flyout menu opens for selecting an email template. Additionally, two further actions are available:
- Create template → In a new browser tab, the creation view of an email template is opened to create a new template.
- Update templates → The list of available email templates is updated.
1.2.8.5. Step 5 - Send email - Add attachment (optional)
After clicking the action icon "Add attachment" (icon "Paperclip"), a flyout menu opens with the actions:
- PDF template → Opens the "Load template" popup window for selecting a PDF template.
- File field → Opens the "Select field" popup window in which a file field from a module can be selected via a picklist.
- Select file → The file explorer of the operating system opens to select files.
1.2.8.6. Step 6 - Send email - Email body (optional)
The email text (email body) can be entered in the editor area. The text can be formatted using the toolbar. The toolbar offers all functionalities for text formatting (e.g. font and size, lists, inserting images and links, tables, etc.).
On mouseover of the "Email body" area, the "Keyboard shortcut" icon (opens the "Keyboard shortcuts" popup) is displayed at the bottom right.
1.2.9. Save email
The "Save email" action stores a scanned email as a copy in the system and links it to further records if applicable.
Save email popup
- Link to
* → picklist for configuring which address the email should be linked to (both addresses can be selected):
- Sender address
- Recipient addresses
- Use blacklist from email account → Switch for configuring whether the blacklist from the email account should be used.
- Responsible for email → Selection of the responsible user/group
- Client for created records * → Selection of the client for the created records
- Create if address not found → picklist for configuring whether a new record should be created if the address is not found. The following values are available for selection:
- no
- as contact
- as lead
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
*Mandatory field
After clicking the "Save" button in the "Save email" popup, the action is saved and displayed in the editor.
1.2.10. Show information
The "Show information" action displays information to the logged-in user that can originate from the main record and its links.
Show information popup
The following fields/functions are available in the "Show information" popup:
- Show information
- Subject → Input field for the subject of the information
- Editor → A formattable message text can be entered in the editor area
- picklist "Type" → picklist with the values "Popup dialog" and "Note" for configuring the type of information
- Popup dialog → a popup dialog with the information is displayed
- Note → A note with the information is displayed. The note can have the following variants (the "Variant" picklist is displayed when the "Note" type is selected):
- Information (blue)
- Success (green)
- Warning (yellow)
- Error (red)
- General
- Name → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Frequency → picklist for when information should be displayed:
- every time → the notification is sent every time the trigger and the condition apply
- once → the notification is sent only once per record when the trigger and the condition apply
- Frequency → picklist for when information should be displayed:
*Mandatory field
1.2.10.1. Step 1 - Show information - Subject
The subject of the information is entered in the input row.
1.2.10.2. Step 2 - Show information - Information
The text of the information can be entered in the editor area. The text can be formatted using the toolbar. The toolbar offers all functionalities for text formatting (e.g. font and size, lists, inserting images and links, tables, etc.).
On mouseover of the "Information" area, the "Keyboard shortcut" icon (opens the "Keyboard shortcuts" popup) is displayed at the bottom right.
1.2.10.3. Step 3 - Type
After clicking the "Type" field (picklist), a picklist opens with the values "Urgent" and "Note" for configuring the type of information.
1.2.11. Edit item
The "Edit item" action allows editing of items in Billing modules.
Edit item popup
The following fields/functions are available in the "Edit item" popup:
- Select item type
- Button "Product" → the input mask for editing a product is displayed
- Button "Service" → the input mask for editing a service is displayed
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Frequency
* → picklist for when a record should be updated:
- every time → the record is updated every time the trigger and the condition apply
- once → the record is updated every time the trigger and the condition apply
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
- Repetition (only available if the value "every time" was selected in the "Frequency" field) → After clicking the "Configure repetition" button, a popup opens with the following fields:
- Input field "Every" → Input field for the duration of the delay of the selected time unit
- picklist "Time unit" → picklist with the time units day(s)/week(s)/month(s)/year(s)
Repeated actions are stopped as soon as the conditions no longer apply at the time the trigger is executed.
- Frequency
* → picklist for when a record should be updated:
*Mandatory field
1.2.11.1. Step 1 - Edit item - Product or service
After clicking the "Product" or the "Service" button, the input mask for configuring the item is displayed.
Edit item popup - Product selected
Edit item popup - Service selected
The following fields/functions are available after selecting a product/service:
- Switch "Reminder fee" → Setting for the reminder fee (active/inactive)
- Item information
- Button "Add field" → a picklist of all available fields for updating is displayed.
- Custom fields
- Button "Add field" → a picklist of all available fields for updating is displayed.
Custom field values when updating items allow the use of fields from references.
- Button "Add field" → a picklist of all available fields for updating is displayed.
After clicking the "Add field" button, a flyout menu opens with the selection of fields from the selected product or service record that should be edited.
In the row of an added field, two action icons are displayed:
- Action icon "Remove field" (icon "Trash") → deletes the field
- Action icon "Configure workspace" (icon "Puzzle") → displays the Set value popup to generate more complex field values
1.2.12. Add item
The "Add item" action allows creation of new items in Billing modules.
Add item popup
The following fields/functions are available in the "Add item" popup:
- Select item type
- Button "Product" → the input mask for configuring a product is displayed
- Button "Service" → the input mask for configuring a service is displayed
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Frequency
* → picklist for when a record should be updated:
- every time → the record is updated every time the trigger and the condition apply
- once → the record is updated every time the trigger and the condition apply
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
- Repetition (only available if the value "every time" was selected in the "Frequency" field) → After clicking the "Configure repetition" button, a popup opens with the following fields:
- Input field "Every" → Input field for the duration of the delay of the selected time unit
- picklist "Time unit" → picklist with the time units day(s)/week(s)/month(s)/year(s)
Repeated actions are stopped as soon as the conditions no longer apply at the time the trigger is executed.
- Frequency
* → picklist for when a record should be updated:
*Mandatory field
1.2.12.1. Step 1 - Add item - Product or service
After clicking the "Product" or the "Service" button, the input mask for configuring the item is displayed.
Add item popup - Product selected
Add item popup - Service selected
The following fields/functions are available after selecting a product/service:
- Field Product or Service → After clicking the action icon "Select record" (icon "three dots with lines"), a popup opens for selecting a product or service.
- Switch "Reminder fee" → Setting for the reminder fee (active/inactive)
1.2.12.2. Step 2 - Add item - Item information
After selecting a product/service, further fields for configuration are displayed:
- Product/service name
* → The product/service name is taken from the selected record and can be changed manually if required.
Action icon "Configure workspace" (icon "Puzzle") → displays the Set value popup to generate more complex field values. - Description → The description of the product/service is taken (formatted) from the selected record and can be changed manually if required.
Action icon "Configure workspace" (icon "Puzzle") → displays the Set value popup to generate more complex field values. - List price → The list price (net) is taken from the selected record and can be changed manually if required.
Action icon "Configure workspace" (icon "Puzzle") → displays the Set value popup to generate more complex field values. - Quantity → The quantity
* is taken from the selected record and can be changed manually if required.
Action icon "Configure workspace" (icon "Puzzle") → displays the Set value popup to generate more complex field values. - Item group * → picklist with all configured item groups
*Mandatory field
1.2.12.3. Step 3 - Add item - Custom fields (optional)
After clicking the "Add field" button, a flyout menu opens with the selection of fields from the selected product or service record that can additionally be added to the item to be added.
In the row of an added field, two action icons are displayed:
- Action icon "Remove field" (icon "Trash") → deletes the field
- Action icon "Configure workspace" (icon "Puzzle") → displays the Set value popup to generate more complex field values
Custom field values when creating items allow the use of fields from references.
1.2.13. Create/update ticket
The "Create/update ticket" action updates tickets based on record numbers or creates new ones if not found, with optional creation of the sender.
This action searches the email for occurrences of record numbers of the Tickets module. If an existing record is identified, an external comment is created for it. If no record is found, a new one is created. Should several records be identified through several numbers, all are updated.
Create/update ticket popup
- Responsible for created records * → Selection of the responsible user/group
- Client for created records * → Selection of the client for the created records
- Search content in addition to subject → Switch for configuring whether the content should be searched in addition to the subject.
- Create missing senders as contact → If no matching sender is identified for the record and this option is inactive, no ticket is created.
- Use blacklist from email account → Switch for configuring whether the blacklist from the email account should be used.
- Link attachments as documents → Switch for configuring whether attachments should be created and linked as a document.
Note: Parallel tasks of the type "Attachments as document" may result in duplicates. - Directory * → Selection of the directory in which the record is stored
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
*Mandatory field
After clicking the "Save" button in the "Create/update ticket" popup, the action is saved and displayed in the editor.
1.2.14. Default interest
The "Default interest" action inserts an item to cover default interest.
Default interest popup
The following fields/functions are available in the "Default interest" popup:
- Select reference product
- Button "Product" → the input mask for configuring a product is displayed
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
*Mandatory field
1.2.14.1. Step 1 - Default interest - Reference product
After selecting a product, further fields for configuration are displayed:
- Base interest rate → numeric input field for specifying the base interest rate
- Taxation type → picklist of the taxation type with the picklist values:
- Accrual taxation
- Cash-basis taxation
- Type of business → picklist of the type of business with the picklist values:
- Consumer transaction (5%)
- Commercial transaction (9%)
- Custom → After selecting the picklist value "Custom", a further field is displayed:
- Custom default interest rate → numeric input field for specifying a freely definable default interest rate
Default interest popup - Reference product selected
1.2.15. Contract update
The "Contract update" action updates the items of a contract, based on a sales order.
The action supports two paths: If the sales order originates from an upgrade deal (contract action "Create upgrade deal" → Deal → Sales order), the associated existing items are updated. If the deal is not generated from the contract and only one contract is linked, the items are created as new items. Both paths can be mixed. Which item corresponds to which case is already determined at the sales order via the sales order flag "Linked item".
If a value is present in the "Billing from" field for an item, the item is written directly into the contract (immediately visible) and only billed from this date onwards – no scheduled action is created.
Optionally, only the items booked via the process of the digital signature can be transferred.
For the "Contract update" action, Record created (module: Sales Orders) is recommended as the trigger. The action should apply as soon as a sales order is newly created – not with every later change of the record.
Contract update popup
The following fields/functions are available in the "Contract update" popup:
- Contract reference → picklist with the preset value "Contract"
- Restrict item groups → picklist (multiple selection possible) of the existing item groups
- General
- Name → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
*Mandatory field
1.2.16. Call webhook
The "Call webhook" action allows the transfer of fields, items or relations of a record to a webhook via a POST or GET call.
Call webhook popup
Call webhook popup - Add text
Call webhook popup - Add field
The following fields/functions are available in the "Call webhook" popup:
- Webhook URL * → Entry of the webhook URL
- Method → picklist of the method (POST or GET)
- Button "Add text" (optional) → Entry of the text parameters
- Name → Name of the text parameter
- Value → Value of the text parameter
- Button "Add field" (optional) → picklist of modules/module fields
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Execute as * → picklist for which user (logged-in user or username) the action is executed as
- Frequency
* → picklist for when a notification should be sent:
- every time → the notification is sent every time the trigger and the condition apply
- once → the notification is sent only once per record when the trigger and the condition apply
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
Note: If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
- Repetition (only available if the value "every time" was selected in the "Frequency" field) → After clicking the "Configure repetition" button, a popup opens with the following fields:
- Input field "Every" → Input field for the duration of the delay of the selected time unit
- picklist "Time unit" → picklist with the time units day(s)/week(s)/month(s)/year(s)
Repeated actions are stopped as soon as the conditions no longer apply at the time the trigger is executed.
*Mandatory field
1.2.17. Item-based calculations
The "Item-based calculations" action enables the calculation of values based on items and writes them into a main field of the record. Supports filtering by conditions.
Item-based calculation popup
Item-based calculation popup - Calculation
The following fields/functions are available in the "Item-based calculations" popup:
- Button "Add calculation" → displays a row with input fields
- Source field from item * → picklist with fields from items for the source field
- Calculation type → picklist for the calculation type (Sum, Average, Minimum and Maximum)
- Target field in record
* → picklist of fields of the module for the target field
Note: Each item-based calculation requires its own trigger along with the associated condition and action. It is not possible to bundle several item-based calculations behind a single trigger.
Example: If the total quantities of two different product categories are to be calculated separately in a sales order and written into their own respective field, two complete automation chains are required for this – each consisting of a trigger, a condition for filtering the product category and the "Item-based calculations" action.
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Execute as * → picklist for which user (logged-in user or username) the action is executed as
- Frequency
* → picklist for when a notification should be sent:
- every time → the notification is sent every time the trigger and the condition apply
- once → the notification is sent only once per record when the trigger and the condition apply
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
*Mandatory field
1.2.18. Update relations
The "Update relations" action updates the relations of the triggering record. Relations to be updated can be restricted by conditions.
Update relations popup
The following fields/functions are available in the "Update relations" popup:
- Object type * → picklist of the object type (module)
- Button "Add field" → displays a row with input fields (fields are only shown after selecting the object type). The fields are grouped by module in the selection.
For the input fields, the action icon Configure workspace (icon "Puzzle") is available. - General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Execute as * → picklist for which user (logged-in user or username) the action is executed as
- Frequency
* → picklist for when a notification should be sent:
- every time → the notification is sent every time the trigger and the condition apply
- once → the notification is sent only once per record when the trigger and the condition apply
- Delay → after clicking the "Configure delay" button, a popup opens with the following fields:
- Input field "Duration" and picklist "Time unit" (optional) → Input field for the duration of the delay of the selected time unit (x minute(s)/hour(s)/day(s)/week(s)/month(s)/year(s) respectively before/after the trigger date)
- Field "Trigger date"
* → picklist with date fields as the basis for the delay
If the field is empty in the record, the action is not executed! - Input field "Time" (optional) → Entry of an optional time
- Switch "Check on every run" → If this setting is active, the conditions are checked on every run of this automation, and the task is postponed or deleted according to the delay.
*Mandatory field
1.2.19. Request payment mandate
The "Request payment mandate" action requests a mandate via the configured payment provider.
This action is available exclusively for the "Record created" trigger in combination with the Contracts module (only CRM version brainX APP) and is only available if a payment provider is configured and activated for the respective client.
The following fields/functions are available in the "Request payment mandate" popup:
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
*Mandatory field
After clicking the Save button in the "Request payment mandate" popup, the action is saved and displayed in the editor.
1.2.20. Payment collection
The "Payment collection" action triggers a payment collection via the configured payment provider (only CRM version brainX APP).
This action is available exclusively for the "Record created" trigger in combination with the Invoices module. The action is only executed if the following prerequisites are met:
- A payment provider is configured and activated for the respective client.
- The invoice originates from a contract for which a valid mandate exists.
The action requires no further configuration apart from assigning a name.
The following fields/functions are available in the "Payment collection" popup:
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
*Mandatory field
After clicking the "Save" button in the "Payment collection" popup, the action is saved and displayed in the editor.
1.2.21. Send SMS
The "Send SMS" action sends personalised SMS.
Send SMS popup
The following fields/functions are available in the "Send notifications" popup:
- SMS
- Source field for phone number * → Selection of the field to which an SMS should be sent (phone, mobile, fax, etc.)
- Message → Input field for the content of the SMS
Note: Placeholders (icon "Puzzle") can be inserted.
- General
- Name * → Entry of an individual name for the action
- Description → Short description of the action (optional)
- Execution
- Execute as
* → picklist for which user (logged-in user or username) the action is executed as
Note: The "Connect" integration must be configured for the executing user. - Frequency
* → picklist for when an SMS should be sent:
- every time → the SMS is sent every time the trigger and the condition apply
- once → the SMS is sent only once per record when the trigger and the condition apply
- Execute as
* → picklist for which user (logged-in user or username) the action is executed as
*Mandatory field
1.3. Delete action
By marking an action (by clicking it, the frame is displayed thicker) and pressing the "Del key", an action can be deleted again in the editor of the automation.
If an already configured action is connected to other configured nodes, it is deleted without further confirmation!
2. Practical examples
1 – Update record: Automatically set status after PDF export
After exporting a quote as a PDF, the status of the deal should be automatically set to sent. Record exported for the Deals module is selected as the trigger. Update record is configured as the action: The Status field is added and the value sent is entered statically.
2 – Send email: Automatically send order confirmation
As soon as a sales order is created, the customer should automatically receive an order confirmation by email. Send email is selected as the action. In the To field, the email field of the linked organisation is entered. The prepared email template Order confirmation is selected as the template. In the Attachment field, the associated PDF template for the sales order is attached. The frequency is set to once so that only one email is sent per sales order.
3 – Create record: Automatically generate invoice after sales order creation
If a new sales order is saved and the Project instalments field has the value no, a total invoice should be created automatically. Create record is configured as the action with the object type Invoices. The reference field links the new invoice with the triggering sales order. The Due date field is filled with the value "current date + 14 days" via the workspace (Set value).
4 – Send notification with delay: Reminder before contract expiry
30 days before a contract expires, the responsible user should receive a notification. Send notification is configured as the action with a delay of 30 days before the Contract end field. The frequency is set to once. The Check on every run switch is activated so that the notification is omitted if the contract has been extended in the meantime.
5 – Show information: Note when opening an overdue record
If a record in the Invoices module is opened and the due date is in the past, a yellow warning note should be displayed to the user. Record opened serves as the trigger. Show information with type Note and variant Warning (yellow) is configured as the action. The subject contains a placeholder with the invoice number.
3. Frequently asked questions
Why can't I configure an action?
An action can only be configured if it is connected to an already configured trigger or an already configured condition. Without this connection, the configuration remains locked.
What is the difference between the frequency "every time" and "once"?
With every time, the action is executed as often as the trigger and the condition apply. With once, the action is executed only once per record – even if the trigger applies again afterwards. For one-off notifications or emails, once is recommended.
What happens if the configured trigger date of a delay is empty?
If the date field configured for the delay is empty in the record, the action is not executed. No error appears – the action is silently skipped.
Can I set several fields in a single "Update record" action?
Yes. Using the Add field button, any number of fields can be configured in a single action. All configured fields are updated simultaneously when the action is triggered.
When should I use "Update record" instead of "Create record"?
Update record changes existing fields in the triggering or linked record. Create record creates a completely new record in another module. If a sales order is to be created after quote acceptance, Create record is the right choice; if only the status of the existing deal is to be changed, Update record is sufficient.
How do I avoid an email being sent multiple times?
Set the frequency of the Send email action to once. This means the email is sent only once per record, even if the trigger applies again afterwards – e.g. because the record is saved again.