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 Cocoonmail.

​
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.

​
Webflow builder

Secondly, you add event properties from an Event received node in the Webflow 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 Webflow builder, as above).

​
Sending event properties in an event

You can add event properties to your Send event API request using eventProperties: 
{
  "email": "sam@cocoonmail.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 Cocoonmail 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.