Skip to main content
{
  "from": {
    "email": "[email protected]",
    "name": "Support Team"
  },
  "to": [
    {
      "email": "[email protected]",
      "name": "John Doe"
    }
  ],
  "subject": "Welcome to Our Service!",
  "htmlBody": "<p>Hi John,</p><p>Welcome aboard!</p>",
  "textBody": "Hi John,\n\nWelcome aboard!",
  "trackOpens": true,
  "trackClicks": true
}

Sender Email and Name

Use the from object to control the sender identity that recipients see in their inbox.
  • from.email (required): The email address. Must use a verified domain in your SendPost account.
  • from.name (optional): The display name shown in email clients.
When both fields are provided, recipients see "Display Name" <[email protected]>. If only from.email is provided, recipients see the email address only.

Common Use Cases

Support Emails

{
  "from": {
    "email": "[email protected]",
    "name": "Support Team"
  }
}
Recipients see: Support Team <[email protected]>

Marketing Emails

{
  "from": {
    "email": "[email protected]",
    "name": "Marketing"
  }
}
Recipients see: Marketing <[email protected]>

Product-Specific Emails

{
  "from": {
    "email": "[email protected]",
    "name": "Product Updates"
  }
}
Recipients see: Product Updates <[email protected]>

Personal-Style Emails

{
  "from": {
    "email": "[email protected]",
    "name": "Sarah from Example"
  }
}
Recipients see: Sarah from Example <[email protected]>

Company Branding

{
  "from": {
    "email": "[email protected]",
    "name": "Example Company"
  }
}
Recipients see: Example Company <[email protected]>

Examples

Order Confirmation (Transactional)

{
  "from": {
    "email": "[email protected]",
    "name": "Order Confirmation"
  },
  "subject": "Your order has been confirmed"
}

Newsletter (Promotional)

{
  "from": {
    "email": "[email protected]",
    "name": "Example Newsletter"
  },
  "subject": "Monthly Newsletter - July 2024"
}

Password Reset (Security)

{
  "from": {
    "email": "[email protected]",
    "name": "Security Team"
  },
  "subject": "Password Reset Request"
}

Best Practices

  • Use clear, recognizable sender names that match the email type.
  • Maintain consistent sender names across similar email types to build recognition.
  • Avoid generic names like “noreply” which may reduce engagement.
The email address in from.email must belong to a domain verified in your SendPost account. Sending from an unverified domain returns an error.
Webhook payloads include the sender name and email, so you can track which sender identity was used for each email event.