Test inboxes for the email your application sends.

// Wait for the password-reset email, then assert on it.
var msg = await mc.AwaitMessageAsync(
    mailboxId,
    to: "alice@acme-ci.mailcatchr.com",
    subject: "Reset your password",
    timeout: TimeSpan.FromSeconds(30));

msg.Should().NotBeNull();
msg!.Subject.Should().Be("Reset your password");

// Read the full body when you need the link inside it.
var detail = await mc.GetMessageAsync(mailboxId, msg.Id);
detail.TextBody.Should().Contain("/reset?token=");

import { createClient } from "@mailcatchr/sdk";

const mc = createClient({ apiKey: process.env.MC_KEY! });

// Need a 2FA code mid-test? Read it from a stored authenticator.
const totp = await mc.totps.code(authenticatorId);
await page.fill('input[name="otp"]', totp.code);

// Send from a verified identity to an address you control.
await mc.send(mailboxId, {
  from: "noreply@acme.send.mailcatchr.com",
  to: "qa@acme-ci.mailcatchr.com",
  subject: "Welcome",
  textBody: "Hi there",
});

# Long-poll until a matching message lands (204 on timeout).
curl -H "Authorization: Bearer $MC_KEY" \
  "https://api.mailcatchr.com/v1/mailboxes/$MAILBOX/messages/await?to=alice@acme-ci.mailcatchr.com&subject=Reset&timeout=30"

# Current code from a stored TOTP authenticator.
curl -H "Authorization: Bearer $MC_KEY" \
  "https://api.mailcatchr.com/v1/totp/$TOTP_ID/code"