CPaaS Guide
API Guide
BlogLogin

Send Mail API

Learn how to use Send Mail API V6.

Overview

The Send Email API enables you to send transactional or promotional emails to one or more recipients using your verified sending domain. Each API call can include custom content, recipients, and delivery options.

Key Components

  • personalizations: Core of the API. Customize:

    • Recipients
    • Subject
    • Content
    • Cc/Bcc

  • settings: Control advanced options like:

    • Engagement tracking
    • Scheduling
    • Global Bcc

Personalization

Send the same content to multiple recipients—customized for each using the personalizations object.

  • Define recipient sets
  • Use attributes to pass dynamic content
  • Send unique emails using shared templates

Tags

Use tags to group emails and track performance by type.

Example:

  • Tag “signup-confirmation” for welcome emails
  • Tag “holiday-offers” for promotions

Tags make reporting and analysis easier.

Priority Flag

Set priorityflag to control delivery speed:

  • 1 – OTP/Transactional
  • 2 – Triggered
  • 3 – Promotional

⚠️

If not set, delivery follows default account/subaccount priority.

Mail Body Compression

Reduce payload size using GZIP compression.

  • Compress your JSON request
  • Set header:
    Content-Encoding: gzip

API Endpoint URLs

  • For Non-EU Customers:
    https://emailapi.netcorecloud.net/

  • For EU Customers:
    https://apieu.netcorecloud.net/

What Does the API Do?

The Email API processes each request, generates emails using the values provided in the payload, and delivers them to the specified recipients.

You can:

  • Send to one or many recipients
  • Customize the subject, content, and Cc/Bcc
  • Control delivery behavior with advanced settings

Key Components

1. Personalizations Object

The personalizations object is at the heart of the Send Email API. It offers flexibility to:

  • Define who receives the email
  • Personalize the subject and content
  • Add Cc and Bcc recipients
  • Modify content for each recipient group using the attributes object

What is Personalization?

If you're sending common content to multiple recipients, personalizations allows you to substitute certain parts with recipient-specific data.

With each personalization object, you can:

  • Set a unique recipient list
  • Pass custom values via the attributes object
  • Personalize emails while using a shared template or content block

This enables delivering unique experiences to each recipient group in a single API call.

2. Settings Object

The settings object allows you to configure:

  • Engagement tracking
  • Scheduled delivery
  • Global Bcc
  • Other advanced delivery controls

3. Tags

The tags parameter helps you segment and track your emails more effectively.

What Are Tags?

Tags are custom labels used to group and categorize emails. They enable tag-wise performance analysis and help in organizing various email types.

Example Use Case:

If you're sending:

  • Signup confirmation emails
  • Festive promotional offers

You can assign tags like signup-confirmation and holiday-offers respectively. This allows you to:

  • Separate performance metrics
  • Optimize content per email category