Dub Docs

General

IntroductionQuick Start

Infrastructure

Cloudflare RoutingNeon DatabaseResend Setup

Application

Auth & SecurityMobile ClientAPI Reference

Created By

Kurou Zagin

Docs

/

Introduction

Star on GitHub

API
Reference & Endpoints.

Dub exposes several endpoints for incoming email processing and data synchronization.

Email Webhook

The endpoint used by Cloudflare Workers to forward incoming emails into your personal database.

Post
/api/webhook/email

Headers

Content-Typeapplication/json
X-Dub-SecretWebhook Secret

Payload Example

{
  "from": "sender@domain.com",
  "to": "you@yourdomain.com",
  "subject": "Hello World",
  "body": "Welcome to your personal email infrastructure.",
  "accountId": "default-account"
}

Auth API (Neon Auth)

Authentication is handled via standard Neon Auth endpoints. The mobile app uses these to verify sessions.

Login

POST /api/auth/login

Session

GET /api/auth/session

Application API

The core application API for managing emails, domains, and identities. All requests require a valid session token.

Emails

Post/api/emails/send— Send an outgoing email
Get/api/emails— List emails by category or identity
Patch/api/emails/[id]— Update email status (Read/Starred/Trash)

Identities & Domains

Get/api/identities— Get user aliases
Post/api/identities— Create a new email alias
Get/api/domains— List verified domains