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: