Stamp0

Quickstart

Get up and running with Stamp0 in minutes. Create your first inbox and start receiving test emails in 5 easy steps.

Get started with Stamp0 in just a few minutes. This guide walks you through creating your first inbox and receiving test emails.

Prerequisites

Before you begin, you'll need:

  • An email address to create your account
  • A project or application that sends emails (for testing)

Create an Account

Go to the Stamp0 Console and click Sign Up:

  1. Enter your email and password
  2. Verify your email address
  3. You'll be redirected to the console

Create an Organization

After signing up, you'll be prompted to create your first organization:

  1. Enter an organization name (e.g., "My Company")
  2. Choose a unique slug (e.g., my-company)
  3. Click Create Organization

Organizations are the top-level container for all your resources. You can create multiple organizations for different companies or clients.

Create a Project

Projects help you organize inboxes by environment or feature:

  1. From the dashboard, click New Project
  2. Enter a project name (e.g., "Production Tests" or "Signup Flow")
  3. Click Create

Common project patterns:

  • By environment: production, staging, development
  • By feature: signup-flow, password-reset, notifications
  • By team: frontend-tests, backend-tests

Create an Inbox

  1. Navigate to your project
  2. Click Create Inbox
  3. Your inbox is created with a unique email address like abc123xyz@stamp0.com

Copy the email address - you'll use this in your application or tests to receive emails.

Start Receiving Emails

Send emails to your inbox address from your application. Emails appear in the console within seconds.

Try it now:

  1. Use your inbox address in a signup form
  2. Trigger a password reset email
  3. Send a test notification

The email will appear in the console where you can:

  • View the full content (HTML and plain text)
  • Check sender and subject
  • Extract verification links or OTPs

What's Next?

Now that you have your first inbox working, explore these next steps:

Quick Code Example

Here's how to use Stamp0 in your tests:

import { Stamp0 } from '@stamp0/sdk';

const stamp0 = new Stamp0({ apiKey: process.env.STAMP0_API_KEY });

// Create a new inbox for this test
const inbox = await stamp0.createInbox({
  projectId: 'prj_abc123'
});

// Use the inbox email in your signup flow
await page.fill('[name="email"]', inbox.address);
await page.click('button[type="submit"]');

// Wait for the verification email
const email = await stamp0.waitForEmail({
  inboxId: inbox.id,
  timeout: 30000,
});

// Extract the verification link
const verifyLink = email.body.match(/https:\/\/[^\s]+verify[^\s]+/)[0];

// Complete verification
await page.goto(verifyLink);

See the Playwright Guide for complete integration instructions and more examples.