👋 Welcome to grap

A simple system to manage temporary email addresses. It ships with the bare minimum of features needed for automation. You can easily self-host it or use this demo for free to get a taste of its simplicity. Check out the documentation for its REST API here.

How does it work?

You can either use the API endpoint or experiment with the dashboard.

    curl -H "Authorization: Bearer <token-here>"

This will give you something like [email protected], a temporary address valid for 30 minutes.

What can I do with it?

It is really up to you: e2e testing, email propagation, other CI/CD integrations etc.

Javascript example
    // generate a temporary address
    const emailAdr = await fetch('', {
        headers: {
            'Authorization': `Bearer ${token}`,
    }).then(r => r.json());
    // do the user registration
    // wait for a confirmation email
    let email;
    while(email?.data?.content === undefined) {
        email = await fetch(`${}/latest`, {
            headers: {
                'Authorization': `Bearer ${token}`,
        }).then(email => email.json());
        // sleep 2 seconds before we poll again
        await new Promise(resolve => setTimeout(resolve, 2000))
    // parse the contents and confirm the registration

Service & Support

At the moment everything is running from a single docker container on a tiny VPS. Even the database is a file powered sqlite. I am planning to keep it that way as long as I can. The project is actively maintained, I am just strongly encouraging you to host it yourself. If you need any help with the setup or maintenance you can find me in my discord server or just spam the service with emails. I might notice the outage and reply..