Overview
This page is for partners who already integrate Entri Connect, Entri Sell, or both, and want to move to the single activateDomain() entry point. After migrating, you make one call and Entri presents the “buy a new domain” or “connect a domain” choice, then routes the user into the matching flow. You no longer maintain your own selection screen or the branching logic that decides which flow to open.
If you only ever offer one path, you don’t need to migrate. showEntri() and purchaseDomain() continue to work unchanged.
Before you start
Entri Activate is available to all partners, so there is no dashboard toggle or account flag to enable first. If your existing Connect or Sell integration works today, you already have everything you need to call activateDomain().
There are two ways to adopt Entri Activate.
Already an Entri customer? You can skip the migration entirely. Entri can turn Activate on for your account with no code change required. Just ping your account executive and we will get you started.
The rest of this page covers the other path: adopting activateDomain() in your own code for full control over configuration and events.
Because the Activate config is a superset of the Connect and Sell configs, the keys you pass today remain valid. See the configuration reference for details.
Migrating from a two-flow integration
If you currently show your own buy-versus-connect screen and call showEntri() or purchaseDomain() depending on the user’s choice, replace that logic with a single activateDomain() call.
Once migrated, you can remove your selection UI and the conditional that branched between the two flows.
Migrating from a single flow
If you call only showEntri() or only purchaseDomain() today and now want to offer both paths, move your existing config into an activateDomain() call and add the keys for the second flow. There are no Activate-specific keys to learn. You combine the same Connect and Sell keys you already know into one object.
For example, a Connect-only integration adding the buy path:
A Sell-only integration adding the connect path works the same way in reverse: keep your purchaseDomain() keys and add the Connect keys for the existing-domain path.
Events after migration
Existing event listeners keep working. The chosen flow fires the same Connect or Sell browser events and webhooks as before, and Activate adds one new onEntriPathSelected event for the selection step. See Activate events.