Event properties

You can include additional data for each event with event properties, which can be used to include personalized information in emails triggered by your events.

Once included in an event, event properties can be added to emails within your loops just like merge tags.

​

Adding event properties

You can add event properties for your events from two places.

​

Events page

Firstly, you can add them from the Events page. Click on an event and then + Add event property.

​

Loop builder

Secondly, you add event properties from an Event received node in the loop builder by clicking on the Edit event properties button.

​

Important information about event properties

• Event properties must have unique names within the same event.
• Empty spaces are trimmed from the beginning and end of property names.
• Event properties can be one of four types:
  • String
  • Number
  • Boolean
  • Date
• Date values can be either a Unix timestamp (in milliseconds) or an ECMA-262 date-time string, similar to contact properties. Read more

​

Editing event properties

You can add, rename, delete, and change data types for event properties in the event editor popup (either from the Events page or within the loop builder, as above).

​

Sending event properties in an event

You can add event properties to your Send event API request using eventProperties:

{
  "email": "[email protected]",
  "eventName": "planChange",
  "firstName": "Sam",
  "favoriteColor": "red",
  "eventProperties": {
    "newPlan": "Pro",
    "oldPlan": "Basic",
    "planPrice": 29,
    "isLifetime": false,
    "updateDate": "2024-03-07T10:09:23Z"
  }
}

Conversion attempts are made for mismatched types (e.g. if you send a string for a number property).

​

Using event properties in emails

Event properties you create become available in emails once Loops has received events containing them.

Click on the Event properties icon ⚡️ in the editor toolbar (only available in emails within your loops) and select the property you want to add.