Send an email

curl -X POST 'https://zapsmtp.xyz/v1/emails' \
  -H "Authorization: Bearer $ZAP_API_KEY" \
  -H 'Idempotency-Key: order-1042-receipt' \
  -H 'Content-Type: application/json' \
  -d '{
  "from": "Acme <hello@acme.com>",
  "to": [
    "delivered@simulator.zapsmtp.xyz"
  ],
  "subject": "Your receipt",
  "html": "<p>Thanks for your order.</p>",
  "tags": [
    {
      "name": "category",
      "value": "receipt"
    }
  ],
  "metadata": {
    "order_id": "A-1042"
  }
}'

const res = await fetch('https://zapsmtp.xyz/v1/emails', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.ZAP_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'order-1042-receipt',
  },
  body: JSON.stringify({
    "from": "Acme <hello@acme.com>",
    "to": [
      "delivered@simulator.zapsmtp.xyz"
    ],
    "subject": "Your receipt",
    "html": "<p>Thanks for your order.</p>",
    "tags": [
      {
        "name": "category",
        "value": "receipt"
      }
    ],
    "metadata": {
      "order_id": "A-1042"
    }
  }),
});
// 204 No Content (e.g. a delete) has no body
const data = res.status === 204 ? null : await res.json();
if (!res.ok) throw new Error(`${data.name}: ${data.message}`);
console.log(data);

import os
import requests

res = requests.post(
    "https://zapsmtp.xyz/v1/emails",
    headers={"Authorization": f"Bearer {os.environ['ZAP_API_KEY']}", "Idempotency-Key": "order-1042-receipt"},
    json={
        "from": "Acme <hello@acme.com>",
        "to": [
            "delivered@simulator.zapsmtp.xyz",
        ],
        "subject": "Your receipt",
        "html": "<p>Thanks for your order.</p>",
        "tags": [
            {
                "name": "category",
                "value": "receipt",
            },
        ],
        "metadata": {
            "order_id": "A-1042",
        },
    },
    timeout=30,
)
res.raise_for_status()
print(res.json() if res.status_code != 204 else "deleted")

<?php
$ch = curl_init('https://zapsmtp.xyz/v1/emails');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('ZAP_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: order-1042-receipt',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'from' => 'Acme <hello@acme.com>',
        'to' => [
            'delivered@simulator.zapsmtp.xyz',
        ],
        'subject' => 'Your receipt',
        'html' => '<p>Thanks for your order.</p>',
        'tags' => [
            [
                'name' => 'category',
                'value' => 'receipt',
            ],
        ],
        'metadata' => [
            'order_id' => 'A-1042',
        ],
    ]),
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 400) {
    throw new RuntimeException($data['message']);
}
print_r($data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "from": "Acme <hello@acme.com>",
  "to": [
    "delivered@simulator.zapsmtp.xyz"
  ],
  "subject": "Your receipt",
  "html": "<p>Thanks for your order.</p>",
  "tags": [
    {
      "name": "category",
      "value": "receipt"
    }
  ],
  "metadata": {
    "order_id": "A-1042"
  }
}`)
	req, err := http.NewRequest(
		"POST",
		"https://zapsmtp.xyz/v1/emails",
		body,
	)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("ZAP_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Idempotency-Key", "order-1042-receipt")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

require 'net/http'
require 'json'

uri = URI('https://zapsmtp.xyz/v1/emails')
req = Net::HTTP::Post.new(uri)
req['Authorization'] = "Bearer #{ENV.fetch('ZAP_API_KEY')}"
req["Idempotency-Key"] = "order-1042-receipt"
req['Content-Type'] = 'application/json'
req.body = {
  from: "Acme <hello@acme.com>",
  to: [
    "delivered@simulator.zapsmtp.xyz"
  ],
  subject: "Your receipt",
  html: "<p>Thanks for your order.</p>",
  tags: [
    {
      name: "category",
      value: "receipt"
    }
  ],
  metadata: {
    order_id: "A-1042"
  }
}.to_json

res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.code, (JSON.parse(res.body) unless res.body.to_s.empty?)

import java.net.URI;
import java.net.http.*;

public class ZapRequest {
    public static void main(String[] args) throws Exception {
        var request = HttpRequest.newBuilder(URI.create("https://zapsmtp.xyz/v1/emails"))
            .header("Authorization", "Bearer " + System.getenv("ZAP_API_KEY"))
            .header("Content-Type", "application/json")
            .header("Idempotency-Key", "order-1042-receipt")
            .method("POST", HttpRequest.BodyPublishers.ofString("""
                {
                  "from": "Acme <hello@acme.com>",
                  "to": [
                    "delivered@simulator.zapsmtp.xyz"
                  ],
                  "subject": "Your receipt",
                  "html": "<p>Thanks for your order.</p>",
                  "tags": [
                    {
                      "name": "category",
                      "value": "receipt"
                    }
                  ],
                  "metadata": {
                    "order_id": "A-1042"
                  }
                }"""))
            .build();
        var response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://zapsmtp.xyz/v1/emails");
request.Headers.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("ZAP_API_KEY"));
request.Headers.Add("Idempotency-Key", "order-1042-receipt");
request.Content = new StringContent("""
    {
      "from": "Acme <hello@acme.com>",
      "to": [
        "delivered@simulator.zapsmtp.xyz"
      ],
      "subject": "Your receipt",
      "html": "<p>Thanks for your order.</p>",
      "tags": [
        {
          "name": "category",
          "value": "receipt"
        }
      ],
      "metadata": {
        "order_id": "A-1042"
      }
    }
    """, Encoding.UTF8, "application/json");

var response = await http.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");