API Reference

const API_KEY = 'your_api_key';
const BASE_URL = 'https://api.devinbox.io';
const headers = { 'X-Api-Key': API_KEY };

// Create temporary mailbox
const response = await fetch(`${BASE_URL}/mailboxes`, {
    method: 'POST',
    headers: { ...headers, 'Content-Type': 'application/json' },
    body: JSON.stringify({ isTemporary: true })
});
const mailbox = await response.json();
const emailAddress = `${mailbox.key}@devinbox.io`;

// Check message count
const countResponse = await fetch(
    `${BASE_URL}/messages/${mailbox.key}/count`,
    { headers }
);
const count = await countResponse.json();
console.log(`Messages: ${count.count}`);

// Get message with template verification
const templateResponse = await fetch(
    `${BASE_URL}/messages/${mailbox.key}/welcome-email/single`,
    { headers }
);
const message = await templateResponse.json();

// Extract template parameters
if (message.templateData.matchSuccess) {
    const userName = message.templateData.subjectParams.UserName;
    const verificationCode = message.templateData.bodyParams.VerificationCode;
    console.log(`User: ${userName}, Code: ${verificationCode}`);
}

import { Configuration, MailboxesApi, MessagesApi } from '@dev-inbox/client-api';

const configuration = new Configuration({
    basePath: 'https://api.devinbox.io',
    baseOptions: {
        headers: { 'X-API-Key': 'your_api_key' }
    }
});
const mailboxesApi = new MailboxesApi(configuration);
const messagesApi = new MessagesApi(configuration);

// Create temporary mailbox
const mailboxResponse = await mailboxesApi.createMailbox({ isTemporary: true });
const mailbox = mailboxResponse.data;
const emailAddress = `${mailbox.key}@devinbox.io`;

// Check message count
const countResponse = await messagesApi.getMessageCount(mailbox.key);
const count = countResponse.data;
console.log(`Messages: ${count.count}`);

// Get message with template verification
const templateResponse = await messagesApi.getSingleMessageWithTemplate(
    mailbox.key,
    'welcome-email'
);
const message = templateResponse.data;

// Extract template parameters
const subject = message.subject as Record<string, string>;
const body = message.body as Record<string, string>;
if (subject && body) {
    const userName = subject.UserName;
    const verificationCode = body.VerificationCode;
    console.log(`User: ${userName}, Code: ${verificationCode}`);
}

using System.Net.Http;
using System.Text;
using System.Text.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "your_api_key");
var baseUrl = "https://api.devinbox.io";

// Create temporary mailbox
var createRequest = new { isTemporary = true };
var json = JsonSerializer.Serialize(createRequest);
var content = new StringContent(json, Encoding.UTF8, "application/json");

var response = await client.PostAsync($"{baseUrl}/mailboxes", content);
var mailboxJson = await response.Content.ReadAsStringAsync();
var mailbox = JsonSerializer.Deserialize<dynamic>(mailboxJson);

// Get last message
var messageResponse = await client.GetAsync(
    $"{baseUrl}/messages/{mailbox.key}/last");
var messageJson = await messageResponse.Content.ReadAsStringAsync();

# Create mailbox
MAILBOX=$(curl -s -X POST https://api.devinbox.io/mailboxes \
  -H "X-Api-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"isTemporary": true}')

# Extract key from response
KEY=$(echo $MAILBOX | jq -r '.key')

# Check message count
curl -H "X-Api-Key: your_api_key" \
  https://api.devinbox.io/messages/$KEY/count

# Get all messages
curl -H "X-Api-Key: your_api_key" \
  https://api.devinbox.io/messages/$KEY

# Get single message (when exactly 1 exists)
curl -H "X-Api-Key: your_api_key" \
  https://api.devinbox.io/messages/$KEY/single

# Get last message with template parsing
curl -H "X-Api-Key: your_api_key" \
  https://api.devinbox.io/messages/$KEY/welcome-template/last