How to Send Your First Email

Sending your first email through Sendses is an essential step. Follow this guide to set up your domain and start sending emails using our API.

Prerequisites

Before sending an email, ensure you have:

Added and Verified Your Domain: Make sure your domain is set up. Domain setup guide.
Generated an API Key: Ensure you have your API key ready. API key generation guide.
Access to the API Documentation: Familiarize yourself with the API endpoints and parameters. API Documentation.

Step-by-Step Guide

Step 1: Verify Domain and API Key

Login to Your Account: Use your Sendses account.
Ensure Domain and API Key Setup: Confirm that your domain is verified and your API key is generated.

Step 2: Send Your First Email

Use API Documentation: Refer to our our documentation to construct your first email-sending request.
Example:

send-email.sh

curl -i -X POST \
    https://api.sendses.com/emails \
    -H 'Authorization: Bearer sendses_...' \
    -H 'Content-Type: application/json' \
    -d '{
    "html": "<html>...</html>",
    "subject": "Email verification",
    "from": "Martins<martins@sendses.com>",
    "to": ['Martins<martins@sendses.com>'],
    "replyTo": ['Sendses Support<support@sendses.com>'],
    "cc": [],
    "bcc": []
    }'

send-email.ts

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

async function run(): Promise<void> {
    const payload = {
        html: '<html>...</html>',
        subject: 'Email verification',
        from: 'Sendses<no-reply@sendses.com>',
        to: ['Martins<martins@sendses.com>'],
        replyTo: ['Sendses Support<support@sendses.com>'],
        cc: [],
        bcc: [],
    };

    try {
        const response: Response = await fetch('https://api.sendses.com/emails', {
            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();

If email was sent successfully then response should look like this:

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

Step 3: Test Email Delivery

Send Test Emails: Send test emails to confirm everything is configured correctly.
Monitor Status: Use the API documentation for retrieving sent emails to check the delivery status and logs to ensure emails are being sent successfully.
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();

Response should look like this:

{
  "success": true,
  "message": "OK",
  "identifier": "OK",
  "responseObject": {
    "id": "email_...",
    "to": [
      "Martins<martins@sendses.com>"
    ],
    "from": "Sendses<no-reply@sendses.com>",
    "subject": "Email verification",
    "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

API Key Errors: Ensure your API key is correctly implemented and has the appropriate permissions.
Authentication Failures: Double-check SPF, DKIM, and DMARC records for accuracy.
Email Deliverability: Review logs for errors or undelivered messages.

Getting Help

If you encounter issues, contact our support team with the following details:

Account email
API key usage logs (if applicable)
Error messages received during sending

Final Steps

After successfully sending your test emails:

Monitor Performance: Use analytics to track email performance and engagement.
Optimize Content: Update email content based on performance insights for better engagement.

FAQs

Why Are My Emails Not Sending?

This could be due to incorrect API usage, authentication failures, or network issues. Review your configurations and consult our troubleshooting guide.

How Do I Manage My API Keys?

Navigate to 'API Keys' within the navigation bar to manage or delete your keys as needed.

By following these steps, you can successfully send emails using our platform's API, ensuring reliable and secure communication.

For more detailed documentation on how to use Domains, visit our documentation.