This event includes:

  • The API method ​UpdateRecipientNoMsg​ or ​UpdateRecipientMsg​ with the parameter ​Self=True​.

This event does not include:

  • The API 2.0 methods ​create​ or ​userCreate.​

  • A contact added to the system in the user interface.

  • A contact added to the system with the time-based job ​Import Addresses​ (see ​Import Contacts​).

Hint:

The designation (C) means contact-related. In general, you only combine contact (C) events with contact (C) 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.

  • Registration to System (REST) (C) + Store Data in Profile Attribute (C): This automation stores data in a contact's profile when he is added to the system via REST API - for example, the date and time of event processing.
    For this combination, check ​Use Event Parameter​ in the field ​User​ on the ​Edit Event-Based Job (window)​.

Define Event​

This area defines the specific parameters of the event.

  • Select by Profile Value: This button creates three new fields. These fields create a selection. They limit the event by selecting only users with certain profile attribute values. Newly registered users who do not have the specified profile attribute values are ignored.
    For example, the event is limited to recipients registered to the system who have the email domain gmail.com.

    • First field: This drop-down list restricts the event to certain profile values. The field displays all standard and custom attributes in the system.

    • Second field: This drop-down list defines the relationship between the attribute (first field) and the value (third field).

    • Third field: This input field defines the attribute value.

    • Equals: The attribute value exactly matches the value in the input field.

    • Does Not Equal: The attribute value does not match the value in the input field.

    • Starts with: The attribute value starts with the value in the input field.

    • Ends with: The attribute value ends with the value in the input field

    • Matches [Regex]: The attribute value matches the regular expression in the input field.

    • =: The attribute value equals the value in the input field (only for numeric, boolean and date attributes).

    • !=: The attribute value does not equal the value in the input field (only for numeric, boolean and date attributes).

    • >: The attribute value is greater than the value in the input field (only for numeric, boolean and date attributes).

    • <: The ne attribute value is less than the value in the input field (only for numeric, boolean and date attributes).

  • Case Insensitive: This checkbox ignores differences in uppercase and lowercase.

Define Selection​

  • Selection: This drop-down list defines a selection. Here, the selection limits the event to recipients added to the system who fulfill the selection criteria. Use the to search for a selection in the system.

Actions

The following actions are available: