Email API Guide: Everything You Need to Know with Code Examples

// Using fetch (Node.js 18+ or with node-fetch)
const response = await fetch('https://api.useplunk.com/v1/send', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    to: 'user@example.com',
    subject: 'Welcome to our platform!',
    body: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
    // Optional fields
    from: 'noreply@yourdomain.com',
    name: 'Your Company',
    replyTo: 'support@yourdomain.com'
  })
});

const data = await response.json();

if (response.ok) {
  console.log('Email sent!', data.emailId);
} else {
  console.error('Failed to send:', data.error);
}

import requests

response = requests.post(
    'https://api.useplunk.com/v1/send',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_API_KEY'
    },
    json={
        'to': 'user@example.com',
        'subject': 'Welcome to our platform!',
        'body': '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
        'from': 'noreply@yourdomain.com',
        'name': 'Your Company'
    }
)

if response.status_code == 200:
    data = response.json()
    print(f"Email sent! ID: {data['emailId']}")
else:
    print(f"Error: {response.json()['error']}")

<?php
$ch = curl_init('https://api.useplunk.com/v1/send');

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_KEY'
]);

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'to' => 'user@example.com',
    'subject' => 'Welcome to our platform!',
    'body' => '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
    'from' => 'noreply@yourdomain.com',
    'name' => 'Your Company'
]));

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($response, true);

if ($httpCode === 200) {
    echo "Email sent! ID: " . $data['emailId'];
} else {
    echo "Error: " . $data['error'];
}
?>

require 'net/http'
require 'json'

uri = URI('https://api.useplunk.com/v1/send')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_KEY'
request.body = {
  to: 'user@example.com',
  subject: 'Welcome to our platform!',
  body: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
  from: 'noreply@yourdomain.com',
  name: 'Your Company'
}.to_json

response = http.request(request)
data = JSON.parse(response.body)

if response.code.to_i == 200
  puts "Email sent! ID: #{data['emailId']}"
else
  puts "Error: #{data['error']}"
end

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

type EmailRequest struct {
    To      string `json:"to"`
    Subject string `json:"subject"`
    Body    string `json:"body"`
    From    string `json:"from"`
    Name    string `json:"name"`
}

func main() {
    email := EmailRequest{
        To:      "user@example.com",
        Subject: "Welcome to our platform!",
        Body:    "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
        From:    "noreply@yourdomain.com",
        Name:    "Your Company",
    }

    jsonData, _ := json.Marshal(email)

    req, _ := http.NewRequest("POST", "https://api.useplunk.com/v1/send", bytes.NewBuffer(jsonData))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)

    if resp.StatusCode == 200 {
        var result map[string]interface{}
        json.Unmarshal(body, &result)
        fmt.Printf("Email sent! ID: %v\n", result["emailId"])
    } else {
        fmt.Println("Error:", string(body))
    }
}