Skip to main content

​
Overview

Most SaaS products depend on a working custom domain to deliver their core value, whether that’s a website, an email address, or a branded storefront. Getting there means the user either buys a domain or configures one they already own, and until that domain is live the user is blocked. They can’t send email from their brand, serve their site, or use whatever your platform sold them. Entri Unify is the call that closes that loop. entri.showUnify(config) presents a centralized modal where the user chooses to buy a new domain or connect an existing one, then routes them through the right Entri flow automatically. When that flow completes, the domain goes from purchased or owned to fully functional inside your platform. Before Unify, offering both paths meant building your own selection UI, writing conditional logic to invoke the right flow, and managing two separate integrations. Unify removes that complexity. You make one call and Entri handles the path selection and the routing.

​
How it works

  1. You call entri.showUnify(config) and Entri opens a centralized modal.
  2. The user chooses between “Buy a new domain” and “Connect a domain.”
  3. Based on that choice, Entri internally routes to the matching flow:
    • Buy a new domain runs the Entri Sell flow (purchaseDomain()), which handles the purchase and auto-configures DNS.
    • Connect a domain runs the Entri Connect flow (connectDomain()), which guides the user through DNS setup for the domain they already own.
  4. Entri applies the records you defined and monitors propagation, just as it does for the underlying flows.
  5. Entri automatically adds the domain to Entri Monitor, which watches its DNS records for later changes.

​
When to use Entri Unify

Use Unify when you want to offer both the purchase and connect paths through a single unified entry point, or when you want Entri to handle the path-selection experience on your behalf. If you only ever need one path, you can continue to call connectDomain() or purchaseDomain() directly. Unify does not replace Connect or Sell as standalone products. It sits in front of them as a single front door for partners who need both.

​
Key features

Single integration replaces the selection UI and branching logic you would otherwise build yourself. One call to showUnify() covers both the purchase and connect paths. Centralized path selection presents the “buy” and “connect” choice in an Entri-managed modal, so you never build or maintain that screen. The modal is built on Entri’s new UI and is themed with the same whiteLabel object as the rest of the flow. Automatic routing sends the user into the Entri Sell or Entri Connect flow based on what they pick, with no state to manage across the two. Consistent configuration lets you define your DNS records once and have them applied no matter which path the user takes, and propagation monitoring carries through from the underlying flow so you’re notified when the domain goes live. Built-in DNS monitoring enrolls every domain in Entri Monitor automatically, so you’re alerted if the records change or break after setup. This is included only with showUnify(). The standalone connectDomain() and purchaseDomain() calls enroll domains in Monitor when you pass monitor: true in the config.

Configuration

Full showUnify() config key reference

Events

Browser events and webhook notifications

Migration

Upgrade an existing Connect or Sell integration

Connect & Sell

The flows Unify routes into