Email Message Reference

const ensend = new Client({
  secret: "your_project_secret",
});

const { data, error } = await ensend.SendApi.SendMailMessage({
  subject: "Ensend Test Email",
  sender: {
    name: "your_identity_name",
    address: "your_sender_identity"
  },
  recipients: [{
    name: "your_recipient_name",
    address: "your_recipient_address"
  }],
   message: "<b>It works 🎉</b>",
  // ...see additional fields below
});

import "github.com/express-labs/ensend-client-go"
client := ensend.New(option.WithProjectSecret("your_project_secret"))

curl -X POST 'https://api.ensend.co/send/mail' \
  -H 'Authorization: Bearer <your_project_secret>' \
  -H 'Content-Type: application/json' \
  -d '{
    "subject": "Ensend Test Email",
    "sender": {
      "name": "your_identity_name",
      "address": "your_sender_identity"
    },
    "recipients": [{
      "name": "your_recipient_name",
      "address": "your_recipient_address"
    }],
    "message": "<b>It works 🎉</b>"
    # ...see additional fields below
  }'

Request Body

string

required

The subject line of the email as it should appear in recipients’ inbox.

string (optional)

The text that appears below the subject line in notifications from inbox clients (like Gmail, Outlook, Apple Mail). This is perfect for sensitive message previews like OTPs in notification.

object

required

Hide Child Attributes

string

The name of the sender as it should appear in recipients’ inbox.If a name is not provided, the username part of the sender address is used. Example: hello becomes the sender name for hello@ensend.co.

string

required

The email address of the sender as it should appear in recipients’ inbox.The sender address can any of the sender identities available to your project. Learn more about creating a sender identity.

string (optional if using template)

The body of the email as it should appear in recipients’ inbox. This can either be in plaintext or html format.

object (optional if using message)

Hide Child Attributes

string

required

This is a reference to any email template available in your project.You can only obtain a ref after creating an email template in your project. Learn more about creating a template.

object (optional)

A key-value pair that assign values to template variables. These variables are treated as global variables and are applied to every message.When variables are specified for each recipient, these are treated as a fallback values.

// Example
{
	"displayPhoto": "https://link-to-avatar.png",
	"citizenship": "Global Citizen"
}

object[]

This is the list of users the broadcast will be delivered to. Recipients can be added in batches, limited to 10 recipients per request.If you’re looking to send to a large list, consider using the broadcast api which lets you send to up to 250 recipients per request.

Hide Child Attributes

string

This is the name of the recipient as it will in your audience list. This name is also used when deriving traits like {{recipient.firstName}} , so you want to ensure it is accurate.If a name is not provided, the username part of the recipient address is used.
Example: tenotea becomes the recipient name for tenotea@ensend.co.

string

The email address of the recipient the broadcast message will be delivered to. This can be any email address which you have received explicit permission to send an email to.

object

A key-value pair that assign values to template variables. These variables override global variables and are only applied to the corresponding recipient, unlocking message personalization at scale.

// Example
{
	"displayPhoto": "https://link-to-profile-picture.png",
	"citizenship": "Brazilian Citizen"
}

string

The email address where replies to your email is sent to.

object[]

Hide Child Attributes

string

The name of the attached file as it should appear in the recipient’s inbox.

You are expected to provide the extension name of the file here. e.g - Resume.pdf

string (optional if using content)

A public link to the direct file being attached.

string (optional if using url)

Base64 content of the file to be attached, useful when sending auto-generated files like receipts.

object

Hide Child Attributes

string

Provide a reference to the audience group recipients of this message should be added to during recipient indexing. Your audience ref can be gotten through the Ensend dashboard. This is useful for adding users to segments.

Getting Started

Email Message

Email Broadcast

Request Body

​Request Body

Request Body