Skip to main content
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 workflows.

​
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. Adding an event property

​
Workflow builder

Secondly, you can add event properties from an Event received node in the workflow builder by clicking Edit event properties in the inspector panel on the right-hand side. Adding an event property in the workflow builder

​
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. Open it from the Events page or from the Event received node in the workflow builder, as above. Editing an event

​
Sending event properties in an event

You can add event properties to your Send event API request using eventProperties: 
{
  "email": "test@example.com",
  "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 workflows) and select the property you want to add. Add an event property
Last modified on May 28, 2026