KM Koushik e3e9635a5f feat: add customizable contact double opt-in flow (#350)
* feat: add customizable contact double opt-in flow

* test: add double opt-in service coverage

* fix: address review comments for double opt-in PR

- Make pending status conditional on doubleOptInEnabled flag
- Backfill legacy unsubscribeReason for reliable pending detection
- Add doubleOptInContent to contact book listing select
- Fix duplicate toast on DOI editor subject save failure
- Harden searchParams parsing against string[] values
- Make default DOI template use link mark for clickable URL
- Make public API create+update atomic via transaction
- Prevent contact upsert failure when DOI email send fails
- Fix empty string template variable replacement

Co-authored-by: opencode <opencode@anthropic.com>

* fix: harden double opt-in confirmation safeguards

Preserve explicit unsubscribe intent in DOI flows and prevent confirmation links from re-subscribing opted-out contacts. Also sanitize subscribe-page error messaging and use timing-safe hash comparison for link verification.

* ui stuff

* fix: require doubleOptInUrl in double opt-in templates

* feat: add configurable from address for double opt-in emails

* feat: add resend confirmation flow for pending contacts

* fix: move subscribe confirmation to explicit POST flow

* test: add contact book public API endpoint coverage

* docs: add double opt-in documentation and update OpenAPI spec

Add a user guide for the double opt-in feature covering setup, contact
statuses, email customization, template variables, and best practices.
Update the OpenAPI spec to include doubleOptIn fields in all contactBook
request/response schemas.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: opencode <opencode@anthropic.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 00:34:20 +11:00
2025-06-02 12:02:45 +10:00
2026-01-18 20:50:54 +11:00
2024-06-24 08:21:37 +10:00
2025-09-03 08:21:55 +10:00
2025-10-12 06:18:04 +11:00
2024-04-22 12:46:53 +10:00
2024-05-25 08:45:27 +10:00
2024-03-15 09:17:00 +11:00
2025-09-03 08:21:55 +10:00
2025-09-03 08:21:55 +10:00

useSend Logo

The Open Source sending infrastructure.
Learn more »

Discord . Website · Issues

Join useSend on Discord GitHub Stars License Docker Automated build

About this project

As most of email products out there, useSend also uses Amazon SES under the hood to send emails. We provide an open and alternative way to send emails reliably and cheaply with a great dashboard. You can also use useSend manage contacts and send bulk emails(newsletter, product updates etc). We will take care of the subscriptions.

Currently we only support emails, but we plan to expand to other sending protocols like SMS, push notification and even whatsapp.

We are currently in beta!

Features

  • Add domains
  • Transactional Mails
  • Rest API
  • Dashboard (Delivered, opened, clicked, bounced)
  • Marketing email
  • SMTP support
  • Schedule API
  • Webhook support
  • BYO AWS credentials

Community and Next Steps 🎯

We're currently working on opening useSend for public beta.

  • Check out the first source code release in this repository and test it.
  • Tell us what you think in the Discussions.
  • Join the Discord server for any questions and getting to know to other community members.
  • the repository to help us raise awareness.
  • Spread the word on Twitter.
  • Fix or create issues, that are needed for the first production release.

Tech Stack

Email editor

Check out the editor code for here. Editor is possible only because of the amazing tools and libraries.

  • jsx-email - converts editor content to html
  • maily.to - useSend email editor is greatly inspired from maily.to
  • tiptap - editor core

Local Development

Follow our detailed guide to run useSend locally

https://docs.usesend.com/get-started/local

Docker

We provide a Docker container for useSend, which is published on both DockerHub and GitHub Container Registry.

DockerHub: https://hub.docker.com/r/usesend/usesend

GitHub Container Registry: https://ghcr.io/usesend/usesend

You can pull the Docker image from either of these registries and run it with your preferred container hosting provider.

Please note that you will need to provide environment variables for connecting to the database, redis, aws and so forth.

For detailed instructions on how to configure and run the Docker container, please refer to the Docker Docker README in the docker directory.

Self Hosting

Checkout the self-hosting guide to learn how to run useSend on your own infrastructure.

Self Hosting with Railway

Railway provides the quickest way to spin up useSend. Read the Railway self-hosting guide or deploy directly:

Deploy on Railway

Star History

Star History Chart

Sponsors

We are grateful for the support of our sponsors.

coderabbit.ai

Other Sponsors

doras.to anaclumos miguilimzero
S
Description
useSend Fork that uses my auth config
Readme 11 MiB
Languages
TypeScript 89.9%
MDX 4.1%
Python 3.7%
CSS 0.8%
PLpgSQL 0.6%
Other 0.8%