CPaaS Guide
API Guide
BlogLogin

Send Mail API

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.

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