Event properties

Learn how to use event properties to personalize your emails.

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.

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

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": "sam@loops.so",
  "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).

New properties not previously defined for an existing event will not be available when sending emails. Make sure you add event properties in Loops before including them in your event requests. If you send a request with a new `eventName` we will create a new event in your account and include the properties listed in `eventProperties`.

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.

{/* Unlike contact properties, fallbacks for event properties are optional. Missing a fallback prints that the property doesn't have one. */}