Skip to content

Newsletters Events

If you need to track all events related to your newsletter, you can access them using the event API. This is useful if you have a DMP or any analytics tool.


This is a premium feature, if you need to access newsletters events please contact

Event types

Events are stored as CSV files, grouped by event type and event day. Each line of the CSV is an event. Since events are grouped by day, you have to wait midnight to download the full events file of the day. These are all the events we store for you:

Event name Description CSV Columns
nl_click When a newsletter is clicked date, email, campaign_id, newsletter_id ,email_list_id, target_id, target_url, target_position
nl_display When a newsletter is opened date, email, campaign_id, newsletter_id ,email_list_id
nl_send When a newsletter is sent to a subscriber date, email, campaign_id, newsletter_id ,email_list_id, active
nl_subscribe When a user is subscribed (CSV import, API, optin...) date, email, email_list_id
nl_unsubscribe When a user is unsubscribed (form, import, API...) date, email, cause, email_list_id
nl_bounce When an email has bounced (both soft and hard bounces) date, email, campaign_id, newsletter_id ,email_list_id, type,message
nl_complaint When an email is marked as junk date, email, campaign_id, newsletter_id ,email_list_id, type

Get an event file

HEADER X-Ownpage-Client-Token

With the parameters:

  • EVENT_NAME : (mandatory) the event name (see first column of table above)
  • DATE : (mandatory) date using format YYYY-MM-DD (where YYYY is the year, MM is the month, DD is the day)

Example, to get clicks events in CSV:

curl -H "X-Ownpage-Client-Token:TOKEN"

Response example:

2018-02-15 23:51:51,,78,6435,131,5117917,,8