SDKs and examples.

using System.Net.Http.Headers;
using System.Net.Http.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("MAILDROP_API_KEY"));
var response = await http.PostAsJsonAsync("https://api.maildrop.online/v1/inboxes", new { local = "checkout-qa", domain = "tests.maildrop.online", lifetime_hours = 24 });
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

const response = await fetch("https://api.maildrop.online/v1/inboxes", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MAILDROP_API_KEY}`,
    Accept: "application/json",
    "Content-Type": "application/json",\n    "Idempotency-Key": crypto.randomUUID()
  },\n  body: JSON.stringify({"local":"checkout-qa","domain":"tests.maildrop.online","lifetime_hours":24})
});
console.log(await response.json());

import os, requests
response = requests.request(
    "POST",
    "https://api.maildrop.online/v1/inboxes",
    headers={"Authorization": f"Bearer {os.environ['MAILDROP_API_KEY']}"},
    json={"local":"checkout-qa","domain":"tests.maildrop.online","lifetime_hours":24},
    timeout=20,
)
response.raise_for_status()
print(response.json())

One security model

• Scoped API keys
• Idempotency-Key support for create calls
• Structured errors and request IDs
• Immediate key revocation
• Signed webhook events