1. Intro
  2. From domains
    1. Get all from domains
    2. Get specific from domain
    3. Create from domain
    4. Verify from domain
    5. Delete from domain
    6. From domain object definition
  3. From addresses
    1. Get all from addresses
    2. Get specific from address
    3. Create from address
    4. Update from address
    5. Delete from address
    6. From address object definitions
  4. Address lists
  5. Templates
    1. Get all templates
    2. Get specific template
    3. Create template
    4. Update template
    5. Delete template
    6. Template object definitions
  6. Campaigns
    1. Get all campaigns
    2. Get specific campaign
    3. Create campaign
    4. Update campaign
    5. Delete campaign
    6. Clone campaign
    7. Get statistics
    8. Get clicks
    9. Get statistics details
    10. How to use triggered campaigns
    11. Campaign object definitions
  7. Mailings
    1. Get all mailings
    2. Get specific mailing
    3. Create mailing
    4. Update mailing
    5. Delete mailing
    6. Get statistics
    7. How to use merge fields
    8. Mailing object definitions
  8. Mails
    1. Create mail
    2. Create triggered mail
    3. Mail object definitions
  9. Unsubscriptions
    1. Get all unsubscriptions
    2. Create unsubscription
    3. Delete unsubscription
    4. Unsubscription object definition
  10. Campaign tags
    1. Get all campaign tags
    2. Get specific campaign tag
    3. Create campaign tag
    4. Update campaign tag
    5. Delete campaign tag
    6. Add campaign tag to campaign
    7. Delete campaign tag from campaign
    8. Campaign tag object
  11. Webhooks
    1. Get webhook
    2. Create or update webhook
    3. Delete webhook
    4. Webhook object definition
    5. How to implement the webhook

Implement the webhook

When mail is processed by our servers, events will be generated. You can receive these events by implementing the webhook. To do this, you'll have to create an API. We will send the updates to you as an array in json format, as seen in the example below.

[ { "MailID": "acf6f71c-2e7b-4b41-b0e2-46657ce40417", "CustomerReference": null, "MailingID": "3af7acf7-1cdf-48ce-b7a5-4ed8027908bb", "EventType": "Opened", "Information": "", "Timestamp": "2019-02-01T13:40:23.613", "TimestampUtc": "2019-02-01T12:40:23.613Z" }, { "MailID": "acf6f71c-2e7b-4b41-b0e2-46657ce40417", "CustomerReference": null, "MailingID": "3af7acf7-1cdf-48ce-b7a5-4ed8027908bb", "EventType": "Clicked", "Information": "https://www.cm.com", "Timestamp": "2019-02-01T13:40:23.613", "TimestampUtc": "2019-02-01T12:40:23.613Z" } ]

Object definition Status Update

Property Type Description
MailID Guid The mailID on which the status update originated
CustomerReference String The CustomerReference that was sent to us while sending the mail
MailingID Guid The mailingID of the mail
EventType String The type of the status update:
Sent = The mail was sent to the recipient
Unsubscribe = The recipient pressed the unsubscribe button in the mail
Delivered = The mail was delivered to the mail server of the recipient
Complaint = The recipient complaint about this mail, for example by clicking the mark as spam button
Bounced = The mail has bounced, this is usually a temporary failure like a busy mailserver
Blacklisted = The recipient is on the blacklist and we didn't send the mail. For example when the recipient pressed the unsubscribe button or the recipient caused a permanent bounce with an earlier mail.
Opened = The recipient opened the mail
ViewedInBrowser = The recipient clicked the view in browser link
Clicked = The recipient clicked a link
PermanentBounced = The address of the recipient caused a permanent bounce. Most likely the mailbox didn't exist. We will add this address to your blacklist
Information String Additional information about the status update, the information in here will depend on the type of status update
Bounced = The response we got from the mail server
PermanentBounced = The response we got from the mail server
Clicked = The link that was clicked
Blacklisted = What kind of type it has on the blacklist
Timestamp DateTime When the status update took place in CET
TimestampUtc DateTime When the status update took place in UTC