Skip to main content

​
About events

Events represent a payload of data that can be used to trigger emails. They can be sent to Cocoonmail with the API or via an integration. Events are used to trigger emails in a workflow and can contain personalized data for each email.

​
Creating events

Events can be created automatically or manually in several ways. As well as specifying a name, you can also create event properties with each of these methods.

​
Automatically by sending an event

You can create an event by sending an event with an event name. For example, creditWarning here is a new event. This request will create a new event in your account. 
{
    "event_name":"suraj",
    "email": "user@example.com", 
    "event_attribute":{
        "surj":"asdf"                 
    }
}

​
Manually from the Events page

Navigate to the Events page to create an event manually.

​
Manually from an Event trigger node

When building a workflow, use the Event received trigger node to create an event (see below).

​
Specifying an event for a Workflow

You can use events to trigger email sending within Cocoonmail. When creating or editing a workflow, select Event received in the “Trigger Type” dropdown. Type in the name of a new event or start typing the name of an existing event, then select from the dropdown.

​
Sending events

Now you have events set up in your Cocoonmail account, you can start sending events using the API or integrations.

​
Sending events with the API

Using the API, send events to the Send event endpoint: 
POST https://webhook.sit.mailrado.com/webhook/send/
All that’s required is an event_name and email to identify the contact, plus the event_name. 
{
    "event_name":"suraj",
    "email": "user@example.com", 
   
}
The event_name can either be an existing event in your account or a new event name. If a contact is not found with the provided email or event_name, a new contact will be created. You can include contact properties in the request, which will be saved onto the contact. These contact properties can be used in emails to your contacts or for filtering and segmenting your audience. 
{
    "event_name":"suraj",
    "email": "user@example.com", 
    "event_attribute":{
        "surj":"asdf"                 
    }
}
To provide your emails with event-specific data, include event properties in the request. Read more about event properties 
{
    "event_name":"suraj",
    "email": "user@example.com", 
    "event_attribute":{
        "surj":"asdf"                 
    }
}

​
Sending events via an integration

Many of our integrations also support sending events, giving you options to send events without building with our API.

​
Viewing and editing events

In your Cocoonmail Settings the Events page shows the list of your different events, including how many times they’ve been sent. Counts are updated hourly.
To edit event properties, click on an event. (You can also edit events by selecting “Edit properties” in the Webflow builder’s event trigger popup.) className=“rounded-lg” alt=“Local Development” src=“/images/events/edit-event.png” /> Events cannot be deleted. Below the list of events, you can see the event stream for your account. This includes events sent to us via the API and any of our integrations. You can sort your events either by email, period of time or event name. You can even create complex segments to view events through a period of time by a single user.