Check out the new lighter, faster webhooks

Say hello to MailerSend webhooks 2.0. We’ve launched an update that makes webhook payloads lighter for better, faster performance.

Webhooks are a much-loved feature, allowing for instant updates and notifications while preserving your resources. We wanted to make our webhooks even better by creating a newer, slicker version that sends a smaller payload, while still providing all of the useful information you need. 

Our previous webhook version included additional data, which led to unnecessary database queries. Webhooks 2.0, with their lighter payload, will be faster, reducing load on the system for sharper performance and less redundant data to deal with. 

To give you a better idea, here’s an example of the old webhook payload compared with webhooks 2.0.

Old webhook payload:

{
  "type": "activity.sent",
  "domain_id": "yv69oxl5kl785kw2",
  "created_at": "2020-11-27T10:08:08.298647Z",
  "webhook_id": "2351ndgwr4zqx8ko",
  "url": "https://your-domain.com/webhook",
  "data": {
    "object": "activity",
    "id": "5fc0d006b42c3e16e1774882",
    "type": "sent",
    "created_at": "2020-11-27T10:08:06.258000Z",
    "email": {
      "object": "email",
      "id": "5fc0d003e7a5e7035446aa32",
      "created_at": "2020-11-27T10:08:03.923000Z",
      "from": "test@mailersend.com",
      "subject": "Test email",
      "status": "sent",
      "tags": null,
      "message": {
        "object": "message",
        "id": "5fc0d003f718c90162341852",
        "created_at": "2020-11-27T10:08:03.017000Z"
      },
      "recipient": {
        "object": "recipient",
        "id": "5f6887d6fd913a6523283fd2",
        "email": "test@mailersend.com",
        "created_at": "2020-09-21T11:00:38.184000Z"
      }
    },
    "template_id": "7nxe3yjmeq28vp0k",
    "morph": null
  }
}

Webhooks 2.0:

{
   "type":"activity.sent",
   "created_at":"2025-08-05T21:23:54.000000Z",
   "data":{
      "id":"6892766a5b66e2daf3dc9155",
      "account_id":1,
      "domain_id":1,
      "message_id":"6892766ae78995a317577aa1",
      "email_id":"6892766a8d52ba62543d5e71",
      "type":"sent",
      "subject":"Qui consequatur hic sit quas.",
      "recipient":"fisher.harley@example.net",
      "tags":[
         "test",
         "test2"
      ],
      "meta":null
   }
}

Choosing the webhook version

You can select which version of webhooks to use when creating or editing a webhook in the app. Webhooks 2.0 is recommended and will be selected by default for all newly created webhooks; however, you can opt to use the original version if you prefer.

Existing webhooks

Any existing webhooks will remain with the 1.0 (Legacy) version, but you can switch to 2.0 by opening the webhook management options on the Domain’s page, clicking on Edit details and selecting 2.0 (Recommended).

Webhooks 2.0 is available now

You can start using the new and improved webhooks now. Any new webhooks you create will be assigned 2.0 by default. If you have any questions or need help, feel free to reach out to our customer support team!