- 2 Minutes to read
- Print
- DarkLight
Group Created (S)
- 2 Minutes to read
- Print
- DarkLight
This event executes a job when a group is created in Engage.
This includes:
Group creation via API with the method groupClone.
Manual group creation in Engage.
Group creation via control XML.
Hint:
In Engage, the designation (S) means system-related. Generally, you only combine system (S) events with system (S) jobs. For more information, see Contact (C) vs. System (S) Automations
General
Name | Defines the name of the automation. The name is used to identify the automation in the system. The maximum length is 100 characters. |
Description | Provides information about the automation. The description makes it easier to identify the automation in the system. |
Event | Selects the type of event that, when combined with a job, forms the automation. Every time this event occurs, the system executes the dependent job. The job is defined in the Edit Event-based Job window. |
Recommended Automations
An automation is a combination of an event plus a resulting job. The following combinations are recommended. It is possible to create other combinations, as well, but not all combinations of events and jobs result in meaningful system behavior.
Group Created (S) + Change Member Read Mode (C): This automation changes the read mode of the group creator after the group is created. The member read mode of other group members is not changed. This automation is useful if you create new groups with the API method groupClone. After the API user creates the group, the automation immediately changes the read mode. This ensures that the system does not send messages to the API user.
When creating the event, the Owner should be limited to the API user. Thus, only groups created by the API user fire the automation.
When defining the job, select the checkbox Use Event Parameter for the fields Contact and Group Name. This specifies that the API user's read mode is changed in the newly created group.
Hint:
You can not use the combination Group Created (S) + Send Prepared Message to Group (S) to send a prepared message to a new group immediately after it is created. This automation is not possible
Define Event
This area defines the specific parameters of the event.
Owner: This field limits the event to groups created by a specific Engage system user. The group creator is also the owner. Click the Search button to search for a specific owner.
Group Email: These fields limit the event to groups created with a certain email address.
Equals: The group email address exactly matches the value in the input field.
Does Not Equal: The group email address does not match the value in the input field.
Starts with: The group email address starts with the value in the input field.
Ends with: The group email address ends with the value in the input field.
Matches [Regex]: The group email address matches the regular expression in the input field.
Group Name: These fields limit the event to groups created with a certain name.
Equals: The group name exactly matches the value in the input field.
Does Not Equal: The group name does not match the value in the input field.
Starts with: The group name starts with the value in the input field.
Ends with: The group name ends with the value in the input field.
Matches [Regex]: The group name matches the regular expression in the input field.
Case Insensitive: This checkbox ignores differences in uppercase and lowercase.
Actions
The following actions are available:
Edit Job: This button saves the changes and opens the Edit Event-Based Job window.