​

MailerSend

​

Profile Requirements

To deliver a message to a recipient over MailerSend, Courier must be provided the recipient’s email address. This value should be included in the recipient profile as email.

{
  "message": {
    // Recipient Profile
    "to": {
      "email": "example@example.com"
    }

    // ... rest of message definition
  }
}

​

Authentication Token Generation

First you need to add your domain and verify it.

Click on “Manage” button and in the following screen generate an authentication token

​

Override

Overrides can be used to change the request body that Courier uses to send an email. Overrides are useful when a field is not yet supported by Courier or you would like to override the value that Courier generates. You can override any of the fields supported by MailerSend’s https://api.mailersend.com/v1/email endpoint (see all mail send request body fields here. Below is an example of overriding the subject:

{
  "message": {
    "template": "<COURIER_NOTIFICATION_ID>",
    "profile": {
      "email": "hello@courier.com"
    },
    "data": {
      "name": "Abdul Ahmady"
    },
    "providers": {
      "mailersend": {
        "override": {
          "config": {
            "apiKey": "<YOUR_OVERRIDDEN_API_KEY>",
            "fromAddress": "<YOUR_OVERRIDDEN_From_ADDRESS>",
            "url": "<YOUR_OVERRIDDEN_URL>"
          }
        }
      }
    }
  }
}

​

MailerSend 422 Response Code

When submitting an API request to MailerSend, you will get a numbered response code. One of the most common response error codes is a 422 error. This could be due to a couple of reasons:

Among these errors, the most common one our users encounter is the email domain verification. Please make sure your email domain is verified with MailerSend before you start using it in your Courier integration.