Webhooks

Manage the statuses of your email campaigns

After sending a campaign, Mail Partner lets you receive statuses via webhooks. For more information, contact us.

Please note

To receive statuses, you must set your webhook URLs

in your Mail API tab

The possible statuses are:

• Delivered: The email was accepted by the recipient's mail server. This indicates a successful delivery.

• Hard-Bounce: Permanent and definitive delivery failure. This means the email address does not exist, is misspelled, or the domain is invalid. The address should be removed from your list.

• Soft-Bounce: Temporary delivery failure. Reasons may include a full inbox, a temporarily down server, or a message that is too large. A new send attempt can be made later.

• Open: Indicates that the recipient opened the email, generally measured by the loading of an invisible pixel. This suggests engagement and the effectiveness of the subject line and preview.

• Click: Means the recipient clicked on one or more links within the email. This reflects high engagement and interest in the email's content.

• Unsubscribe: The recipient clicked on the unsubscribe link, indicating they no longer wish to receive emails. It is crucial to process this request immediately by removing the address from your sending list.

• Spam: The email was marked as spam or blocked by a spam filter. This seriously harms your sender reputation and requires treating the address as a forced unsubscribe.

Example of a JSON status sent via POST

{
  "hook": "open",
  "datas": {
    "op": "open",
    "at": 1764770972,
    "from": "[e-mail]",
    "message_id": "xxxxxx"
  }
}

{
  "hook": "open",
  "datas": {
    "op": "first_open",
    "at": 1764770972,
    "from": "[e-mail]",
    "message_id": "xxxxxx"
  }
}  

{
  "hook": "delivered",
  "datas": {
    "op": "delivered",
    "at": 1764770972,
    "from": "[e-mail]",
    "message_id": "xxxxxx"
  }
}

{
  "hook": "click",
  "datas": {
    "op": "click",
    "at": 1764770972,
    "from": "[e-mail]",
    "message_id": "xxxxxx"
  }
}

{
  "hook": "hard-bounce",
  "datas": {
    "op": "hard-bounce",
    "at": 1764770972,
    "from": "[e-mail]",
    "message_id": "xxxxxx"
  }
}

{
  "hook": "soft-bounce",
  "datas": {
    "op": "soft-bounce",
    "at": 1764770972,
    "from": "[e-mail]",
    "message_id": "xxxxxx"
  }
}