How to Send Batch Emails

Sending batch emails through Sendses is an essential method for efficiently reaching multiple recipients at once. This guide outlines how to set up your domain and send batch emails using our API.

Prerequisites

Before sending batch emails, ensure you have:

Added and Verified Your Domain: Your domain must be fully set up. Domain setup guide.
Generated an API Key: Have your API key accessible. API key generation guide.
Access to the API Documentation: Understand the API endpoints and parameters pertinent to batch email operations. API Documentation.

Step-by-Step Guide

Step 1: Verify Domain and API Key

Login to Your Sendses Account: Access your account on Sendses.
Confirm Domain and API Key Setup: Ensure both the domain is verified and the API key is generated for batch operations.

Step 2: Prepare and Send Batch Emails

Use the API Documentation: Follow our batch email API documentation to create the necessary request for sending batch emails.
Example:

send-email.sh

curl -i -X POST \
    https://api.sendses.com/emails/batch \
    -H 'Authorization: Bearer sendses_...' \
    -H 'Content-Type: application/json' \
    -d '[
      {
        "html": "<html>...</html>",
        "subject": "Notification",
        "from": "Martins<martins@sendses.com>",
        "to": ['Martins<martins@sendses.com>'],
        "replyTo": ['Sendses Support<support@sendses.com>'],
        "cc": [],
        "bcc": []
      },
      {
        "text": "Your attention is required.",
        "subject": "Notification",
        "from": "Martins<martins@sendses.com>",
        "to": ['Alex<alex@anotherdomain.com>', 'Jordan<jordan@thirdomain.com>'],
        "replyTo": ['Sendses Support<support@sendses.com>'],
        "cc": ['Charlie<charlie@examplenet.com>'],
        "bcc": []
      }
    ]'

send-email.ts

import fetch, { Response } from 'node-fetch';

async function run(): Promise<void> {
    const payload = [
      {
        html: '<html>...</html>',
        subject: 'Notification',
        from: 'Sendses<no-reply@sendses.com>',
        to: ['Martins<martins@sendses.com>'],
        replyTo: ['Sendses Support<support@sendses.com>'],
        cc: [],
        bcc: [],
      },
      {
        text: 'Your attention is required.',
        subject: 'Notification',
        from: 'Sendses<no-reply@sendses.com>',
        to: ['Alex<alex@anotherdomain.com>', 'Jordan<jordan@thirdomain.com>'],
        replyTo: ['Sendses Support<support@sendses.com>'],
        cc: ['Charlie<charlie@examplenet.com>'],
        bcc: [],
      },
    ];

    try {
        const response: Response = await fetch('https://api.sendses.com/emails/batch', {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json',
                Authorization: 'Bearer sendses_...', // Replace with your API Key
            },
            body: JSON.stringify(payload),
        });

        if (!response.ok) {
            throw new Error(`HTTP error! Status: ${response.status}`);
        }

        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error sending email:', error);
    }
}

run();

Upon successful email sending, the response should look like this:

{
  "success": true,
  "message": "Created",
  "identifier": "CREATED",
  "responseObject": [{ "id": "email_..." }, { "id": "email_..." }],
  "statusCode": 201
}

Step 3: Verify Email Delivery

Send Test Batch Emails: Send a test batch to verify settings and configurations.
Monitor Delivery Status: Utilize our API endpoint documentation to track email delivery statuses and logs, confirming the success of batch sending.
Example:

get-email.sh

curl -i -X GET \
  'https://api.sendses.com/emails/{emailId}' \
  -H 'Authorization: Bearer sendses_...'

get-email.ts

import fetch from 'node-fetch';

async function run() {
  const emailId = 'email_...';
  const resp = await fetch(
    `https://api.sendses.com/emails/${emailId}`,
    {
      method: 'GET',
      headers: {
        Authorization: 'Bearer sendses_...' // Replace with your API Key
      }
    }
  );

  const data = await resp.text();
  console.log(data);
}

run();

The response for delivery confirmation should be:

{
  "success": true,
  "message": "OK",
  "identifier": "OK",
  "responseObject": {
    "id": "email_...",
    "to": ["Martins<martins@sendses.com>"],
    "from": "Sendses<no-reply@sendses.com>",
    "subject": "Notification",
    "bcc": [],
    "cc": [],
    "reply_to": ["Sendses Support<support@sendses.com>"],
    "html": "<html>...</html>",
    "text": null,
    "created_at": "2024-10-07 12:04:16.527053+00",
    "updated_at": "2024-10-07 12:04:19.101+00",
    "last_event_type": "delivered",
    "domain_id": "domain_...",
    "domain": {
      "id": "domain_...",
      "enabled": true,
      "name": "sendses.com",
      "region": "us-east-1",
      "verified": true,
      "created_at": "2024-10-04 10:17:42.30534+00",
      "updated_at": "2024-10-04 10:19:05.414+00"
    },
    "events": [
      {
        "id": "event_...",
        "type": "sent",
        "timestamp": "2024-10-07T12:04:16.807+00:00"
      },
      {
        "id": "event_...",
        "type": "delivered",
        "timestamp": "2024-10-07T12:04:17.853+00:00"
      }
    ]
  },
  "statusCode": 200
}

Troubleshooting

Common Issues

Quota Exceedance: Make sure your email volume fits within your daily or monthly sending quotas. Requests that exceed these limits will be denied.
API Key Errors: Verify the correct implementation and permissions of your API key.
Authentication Failures: Check SPF, DKIM, and DMARC records for correct configuration.
Email Deliverability: Investigate logs for errors or issues in message delivery.

Getting Help

For issues, reach out to our support team with details like:

Account email
API key usage records (if applicable)
Error messages encountered during the sending process

Final Steps

Once test batch emails are sent successfully:

Monitor Performance: Use analytics tools to assess email delivery performance and engagement metrics.
Optimize Content: Refine email content based on insights to improve future engagement.

FAQs

Why Are My Batch Emails Not Sending?

Problems may arise from incorrect API usage, authentication errors, or connection issues. Review your setup and consult our troubleshooting section.

How Do I Manage My API Keys?

Go to 'API Keys' in the navigation to manage or remove keys as needed.

Following these steps will enable you to send effective batch emails via our platform's API, ensuring you maintain reliable communication with your audience.

For additional documentation regarding Domains, see our documentation.