Upgrade an existing Connect or Sell integration to the unified Unify flow.
Overview
This page is for partners who already integrate Entri Connect, Entri Sell, or both, and want to move to the single showUnify() 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. connectDomain() and purchaseDomain() continue to work unchanged.
Before you start
If your existing Connect or Sell integration works today, you already have everything you need to call showUnify().There are two ways to adopt Entri Unify.
If you prefer to not make any code changes, you can force Unify on by navigating to your application settings and enabling “Force Unify”.
The rest of this page covers the other path: adopting showUnify() in your own code for full control over configuration and events.Because the Unify 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 connectDomain() or purchaseDomain() depending on the user’s choice, replace that logic with a single showUnify() call.
// Before: your UI decides, then you call one flow or the otherif (userChoseToBuy) { entri.purchaseDomain(sellConfig);} else { entri.connectDomain(connectConfig);}// After: Entri presents the choice and routes internallyentri.showUnify({ ...sharedConfig, // Connect and Sell keys both live in this one object});
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 connectDomain() or only purchaseDomain() today and now want to offer both paths, move your existing config into a showUnify() call and add the keys for the second flow. There are no Unify-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:
// Before: connect-only, your existing connectDomain() callentri.connectDomain({ applicationId: "YOUR_APPLICATION_ID", token: "GENERATED_JWT", dnsRecords: [ // ...records applied after the user connects their domain ],});// After: same Connect keys, plus the Sell keys for the buy pathentri.showUnify({ applicationId: "YOUR_APPLICATION_ID", token: "GENERATED_JWT", dnsRecords: [ // ...same records, applied whether the user connects or buys ], // ...add the Sell keys you would pass to purchaseDomain()});
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.
Monitoring after migration
Moving to showUnify() changes one default: every domain that completes the flow is automatically added to Entri Monitor. With connectDomain() or purchaseDomain(), monitoring required monitor: true in the config. With showUnify() it is included, so you can drop that flag from the config you carry over. If you don’t want the domains monitored, pass monitor: false instead.
Events after migration
Existing event listeners keep working. The chosen flow fires the same Connect or Sell browser events and webhooks as before, and Unify adds one new onEntriPathSelected event for the selection step. See Unify events.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Entri","colors":{"primary":"#0A6CFF","light":"#6FA8FF","dark":"#0A6CFF"},"logo":{"light":"https://mintcdn.com/entri-42/y89yB6zwvoVA7ecV/logo/light.png?fit=max\u0026auto=format\u0026n=y89yB6zwvoVA7ecV\u0026q=85\u0026s=ceeb1d939278e2be178383e2857c13eb","dark":"https://mintcdn.com/entri-42/y89yB6zwvoVA7ecV/logo/dark.png?fit=max\u0026auto=format\u0026n=y89yB6zwvoVA7ecV\u0026q=85\u0026s=b06c4ce73c6f00aca4d3a47a9b62d2c8"},"favicon":"https://mintcdn.com/entri-42/y89yB6zwvoVA7ecV/favicon.png?fit=max\u0026auto=format\u0026n=y89yB6zwvoVA7ecV\u0026q=85\u0026s=3593d603249ee01517f07fc9c4265701","appearance":{"default":"light"},"background":{"color":{"light":"#F9FAFB","dark":"#0A0E14"}},"navbar":{"links":[{"href":"https://dashboard.entri.com/login","label":"Login"}],"primary":{"type":"button","label":"Get Entri","href":"https://www.entri.com/products/connect?utm_term=entri\u0026utm_campaign=Entri+Search+Campaign\u0026utm_source=adwords\u0026utm_medium=ppc\u0026hsa_acc=7813870670\u0026hsa_cam=16449479279\u0026hsa_grp=133925002277\u0026hsa_ad=650360294556\u0026hsa_src=g\u0026hsa_tgt=kwd-370487985543\u0026hsa_kw=entri\u0026hsa_mt=e\u0026hsa_net=adwords\u0026hsa_ver=3\u0026gclid=CjwKCAiAmZGrBhAnEiwAo9qHidBkNlxGpprRtbfawek2vGlSGuVLHUFqeaUbuwNzGS2MjAb8UcmCbRoCL-4QAvD_BwE"}},"footer":{"socials":{"twitter":"https://twitter.com/ThisIsEntri","linkedin":"https://www.linkedin.com/company/entri1"}},"fonts":{"family":"Spline Sans"},"styling":{"codeblocks":"system","latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"entri-42","hasAudioNarration":false,"actualSubdomain":"entri-42","customDomains":["developers.entri.com"],"gitSource":{"type":"github","owner":"entri-dns","repo":"public-docs","deployBranch":"master","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af78ec5200305d1f9c46c68","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Activate Suite","count":24},{"language":"default","tag":"Connect","count":11},{"language":"default","tag":"Domain Management","count":5},{"language":"default","tag":"Power","count":5},{"language":"default","tag":"Sell","count":5},{"language":"default","tag":"DNS Concepts","count":4},{"language":"default","tag":"Monitor","count":4},{"language":"default","tag":"SSL Provisioning","count":4},{"language":"default","tag":"Secure","count":4},{"language":"default","tag":"The Unify Function","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"styles.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iCr6K5wfMRRjxp0DA6-2CLnB45HhrUI.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iCr6K5wfMRRjxp0DA6-2CLnB41HhrUI.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iCr6K5wfMRRjxp0DA6-2CLnB4NHhg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\ncode,pre,kbd,samp{font-family:\"Fragment Mono\", ui-monospace, SFMono-Regular, Menlo, monospace}"}],"page":{"pagePath":"unify/migration","slug":"/unify/migration","pageMetadata":{"title":"Migrating to Entri Unify","sidebarTitle":"Migration","description":"Upgrade an existing Connect or Sell integration to the unified Unify flow.","href":"/unify/migration"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Upgrade an existing Connect or Sell integration to the unified Unify flow.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`This page is for partners who already integrate Entri Connect, Entri Sell, or both, and want to move to the single `,_jsx(_components.code,{children:`showUnify()`}),` 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.`]}),`\n`,_jsxs(_components.p,{children:[`If you only ever offer one path, you don’t need to migrate. `,_jsx(_components.code,{children:`connectDomain()`}),` and `,_jsx(_components.code,{children:`purchaseDomain()`}),` continue to work unchanged.`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(_components.p,{children:[`If your existing Connect or Sell integration works today, you already have everything you need to call `,_jsx(_components.code,{children:`showUnify()`}),`.`]}),`\n`,_jsx(_components.p,{children:`There are two ways to adopt Entri Unify.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`If you prefer to not make any code changes, you can force Unify on by navigating to your application settings and enabling `,_jsx(_components.strong,{children:`“Force Unify”`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[`The rest of this page covers the other path: adopting `,_jsx(_components.code,{children:`showUnify()`}),` in your own code for full control over configuration and events.`]}),`\n`,_jsxs(_components.p,{children:[`Because the Unify config is a superset of the Connect and Sell configs, the keys you pass today remain valid. See the `,_jsx(_components.a,{href:`/unify/configuration`,children:`configuration reference`}),` for details.`]}),`\n`,_jsx(Heading,{level:`2`,id:`migrating-from-a-two-flow-integration`,children:`Migrating from a two-flow integration`}),`\n`,_jsxs(_components.p,{children:[`If you currently show your own buy-versus-connect screen and call `,_jsx(_components.code,{children:`connectDomain()`}),` or `,_jsx(_components.code,{children:`purchaseDomain()`}),` depending on the user’s choice, replace that logic with a single `,_jsx(_components.code,{children:`showUnify()`}),` call.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Before: your UI decides, then you call one flow or the other`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`userChoseToBuy`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` entri`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`purchaseDomain`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`sellConfig`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`} `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`else`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` entri`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`connectDomain`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`connectConfig`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// After: Entri presents the choice and routes internally`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`entri`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`showUnify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ...`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`sharedConfig`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // Connect and Sell keys both live in this one object`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Once migrated, you can remove your selection UI and the conditional that branched between the two flows.`}),`\n`,_jsx(Heading,{level:`2`,id:`migrating-from-a-single-flow`,children:`Migrating from a single flow`}),`\n`,_jsxs(_components.p,{children:[`If you call only `,_jsx(_components.code,{children:`connectDomain()`}),` or only `,_jsx(_components.code,{children:`purchaseDomain()`}),` today and now want to offer both paths, move your existing config into a `,_jsx(_components.code,{children:`showUnify()`}),` call and add the keys for the second flow. There are no Unify-specific keys to learn. You combine the same Connect and Sell keys you already know into one object.`]}),`\n`,_jsx(_components.p,{children:`For example, a Connect-only integration adding the buy path:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`18`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`18`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Before: connect-only, your existing connectDomain() call`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`entri`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`connectDomain`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` applicationId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"YOUR_APPLICATION_ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` token:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"GENERATED_JWT\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` dnsRecords:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // ...records applied after the user connects their domain`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// After: same Connect keys, plus the Sell keys for the buy path`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`entri`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`showUnify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` applicationId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"YOUR_APPLICATION_ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` token:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"GENERATED_JWT\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` dnsRecords:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // ...same records, applied whether the user connects or buys`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // ...add the Sell keys you would pass to purchaseDomain()`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`A Sell-only integration adding the connect path works the same way in reverse: keep your `,_jsx(_components.code,{children:`purchaseDomain()`}),` keys and add the Connect keys for the existing-domain path.`]}),`\n`,_jsx(Heading,{level:`2`,id:`monitoring-after-migration`,children:`Monitoring after migration`}),`\n`,_jsxs(_components.p,{children:[`Moving to `,_jsx(_components.code,{children:`showUnify()`}),` changes one default: every domain that completes the flow is automatically added to `,_jsx(_components.a,{href:`/monitor/overview`,children:`Entri Monitor`}),`. With `,_jsx(_components.code,{children:`connectDomain()`}),` or `,_jsx(_components.code,{children:`purchaseDomain()`}),`, monitoring required `,_jsx(_components.code,{children:`monitor: true`}),` in the config. With `,_jsx(_components.code,{children:`showUnify()`}),` it is included, so you can drop that flag from the config you carry over. If you don’t want the domains monitored, pass `,_jsx(_components.code,{children:`monitor: false`}),` instead.`]}),`\n`,_jsx(Heading,{level:`2`,id:`events-after-migration`,children:`Events after migration`}),`\n`,_jsxs(_components.p,{children:[`Existing event listeners keep working. The chosen flow fires the same Connect or Sell browser events and webhooks as before, and Unify adds one new `,_jsx(_components.code,{children:`onEntriPathSelected`}),` event for the selection step. See `,_jsx(_components.a,{href:`/unify/events`,children:`Unify events`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Migrating to Entri Unify","sidebarTitle":"Migration","description":"Upgrade an existing Connect or Sell integration to the unified Unify flow.","href":"/unify/migration"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Migrating from a two-flow integration","slug":"migrating-from-a-two-flow-integration","depth":2,"children":[]},{"title":"Migrating from a single flow","slug":"migrating-from-a-single-flow","depth":2,"children":[]},{"title":"Monitoring after migration","slug":"monitoring-after-migration","depth":2,"children":[]},{"title":"Events after migration","slug":"events-after-migration","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"entri-42","siteName":"Entri","title":"Migrating to Entri Unify - Entri","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-24T16:30:02.504Z","originalFileLocation":"unify/migration.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Upgrade an existing Connect or Sell integration to the unified Unify flow.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Entri\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/entri-42/faKIwQdisx00CKto/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/entri-42/faKIwQdisx00CKto/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/entri-42/faKIwQdisx00CKto/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/entri-42/faKIwQdisx00CKto/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/entri-42/faKIwQdisx00CKto/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/entri-42/faKIwQdisx00CKto/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/entri-42/faKIwQdisx00CKto/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/entri-42/faKIwQdisx00CKto/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/entri-42/faKIwQdisx00CKto/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Migrating to Entri Unify - Entri\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upgrade an existing Connect or Sell integration to the unified Unify flow.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Entri\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.entri.com/unify/migration\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://entri-42.mintlify.site/_mintlify/api/og/v2?division=The+Unify+Function\u0026amp;title=Migrating+to+Entri+Unify\u0026amp;description=Upgrade+an+existing+Connect+or+Sell+integration+to+the+unified+Unify+flow.\u0026amp;theme=74926d458b9ab599651b467e\u0026amp;signature=2aca2a4a3647229abbdd206c8f58bfa73837501e234dcaf39bf4f70de9799ae0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Migrating to Entri Unify - Entri\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upgrade an existing Connect or Sell integration to the unified Unify flow.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://entri-42.mintlify.site/_mintlify/api/og/v2?division=The+Unify+Function\u0026amp;title=Migrating+to+Entri+Unify\u0026amp;description=Upgrade+an+existing+Connect+or+Sell+integration+to+the+unified+Unify+flow.\u0026amp;theme=74926d458b9ab599651b467e\u0026amp;signature=2aca2a4a3647229abbdd206c8f58bfa73837501e234dcaf39bf4f70de9799ae0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/entri-42/faKIwQdisx00CKto/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Entri\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A6CFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.entri.com/unify/migration\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/unify/migration.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.entri.com/#organization\",\"name\":\"Entri\",\"url\":\"https://developers.entri.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/entri-42/y89yB6zwvoVA7ecV/logo/light.png?fit=max\u0026auto=format\u0026n=y89yB6zwvoVA7ecV\u0026q=85\u0026s=ceeb1d939278e2be178383e2857c13eb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.entri.com#website\",\"name\":\"Entri\",\"url\":\"https://developers.entri.com\",\"publisher\":{\"@id\":\"https://developers.entri.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.entri.com/unify/migration#webpage\",\"url\":\"https://developers.entri.com/unify/migration\",\"name\":\"Migrating to Entri Unify\",\"description\":\"Upgrade an existing Connect or Sell integration to the unified Unify flow.\",\"dateModified\":\"2026-08-24T16:30:02.504Z\",\"isPartOf\":{\"@id\":\"https://developers.entri.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.entri.com/unify/migration#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.entri.com/unify/migration#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Activate Suite\",\"item\":\"https://developers.entri.com/unify/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"The Unify Function\",\"item\":\"https://developers.entri.com/unify/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Migrating to Entri Unify\",\"item\":\"https://developers.entri.com/unify/migration\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.entri.com/unify/migration#article\",\"headline\":\"Migrating to Entri Unify\",\"name\":\"Migrating to Entri Unify\",\"description\":\"Upgrade an existing Connect or Sell integration to the unified Unify flow.\",\"url\":\"https://developers.entri.com/unify/migration\",\"mainEntityOfPage\":{\"@id\":\"https://developers.entri.com/unify/migration#webpage\"},\"dateModified\":\"2026-08-24T16:30:02.504Z\",\"publisher\":{\"@id\":\"https://developers.entri.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.entri.com#website\"}}]}\u003c/script>","agentPointerHref":"/unify/migration.md","siteName":"Entri","nav":{"global":null,"groups":[{"group":"Get Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/getting-started"},{"title":"React Integration","href":"/integration/react"},{"title":"Vanilla JavaScript Integration","href":"/integration/vanilla-js"}]},{"group":"Activate Suite","icon":"cubes","pages":[{"group":"The Unify Function","icon":"layer-group","pages":[{"title":"Entri Unify Overview","sidebarTitle":"Overview","href":"/unify/overview"},{"title":"Entri Unify Configuration","sidebarTitle":"Configuration","href":"/unify/configuration"},{"title":"Entri Unify Events","sidebarTitle":"Events","description":"Browser events and webhook notifications fired during the Unify flow.","href":"/unify/events"},{"title":"Migrating to Entri Unify","sidebarTitle":"Migration","href":"/unify/migration"}]},{"group":"Connect","icon":"wifi","pages":[{"title":"Entri Connect Overview","sidebarTitle":"Overview","description":"Guided DNS setup for your users: what Entri Connect is and when to use it.","href":"/connect/overview"},{"title":"Connect SDK","sidebarTitle":"SDK","href":"/connect/sdk"},{"title":"Connect Configuration","sidebarTitle":"Configuration","href":"/connect/configuration"},{"title":"Connect White Label","sidebarTitle":"White Label","href":"/connect/white-label"},{"title":"Connect White Label (Legacy Keys)","sidebarTitle":"White Label (Legacy)","href":"/connect/white-label-legacy"},{"title":"Connect DNS Records","sidebarTitle":"DNS Records","href":"/connect/dns-records"},{"title":"Multi-Domain \u0026 Conditional Records","href":"/connect/multi-domain"},{"title":"Shared Links","href":"/connect/shared-links"},{"title":"Connect Events","sidebarTitle":"Events","href":"/connect/events"},{"title":"Supported Providers","href":"/connect/provider-list"},{"title":"Brand Protection","href":"/connect/brand-protection"}]},{"group":"Sell","icon":"browser","pages":[{"title":"Entri Sell Overview","sidebarTitle":"Overview","href":"/sell/overview"},{"title":"Sell Modal Integration","sidebarTitle":"Modal Integration","href":"/sell/modal-integration"},{"title":"Sell White Label","sidebarTitle":"White Label","href":"/sell/white-label"},{"title":"Sell SDK","sidebarTitle":"SDK","href":"/sell/sdk"},{"title":"Sell Events","sidebarTitle":"Events","href":"/sell/events"}]},{"group":"Monitor","icon":"wave-pulse","pages":[{"title":"Entri Monitor Overview","sidebarTitle":"Overview","href":"/monitor/overview"},{"title":"Monitor Configuration","sidebarTitle":"Configuration","href":"/monitor/configuration"},{"title":"Monitor Endpoints","sidebarTitle":"Endpoints","href":"/monitor/endpoints"},{"title":"Monitor Events","sidebarTitle":"Events","href":"/monitor/events"}]}]},{"group":"Domain Management","icon":"sliders","pages":[{"group":"Power","icon":"bolt","pages":[{"title":"Entri Power Overview","sidebarTitle":"Overview","href":"/power/overview"},{"title":"Power Configuration","sidebarTitle":"Configuration","href":"/power/configuration"},{"title":"Power Endpoints","sidebarTitle":"Endpoints","href":"/power/endpoints"},{"title":"Root Path Access","href":"/power/root-path-access"},{"title":"Power Events","sidebarTitle":"Events","href":"/power/events"}]}]},{"group":"SSL Provisioning","icon":"certificate","pages":[{"group":"Secure","icon":"lock","pages":[{"title":"Entri Secure Overview","sidebarTitle":"Overview","href":"/secure/overview"},{"title":"Secure Configuration","sidebarTitle":"Configuration","href":"/secure/configuration"},{"title":"Secure Endpoints","sidebarTitle":"Endpoints","href":"/secure/endpoints"},{"title":"Secure Events","sidebarTitle":"Events","href":"/secure/events"}]}]},{"group":"For DNS Providers","icon":"network-wired","pages":[{"group":"Network","icon":"globe","pages":[{"title":"Entri Network Overview","sidebarTitle":"Overview","href":"/network/overview"},{"title":"DNS Provider Onboarding","href":"/network/dns-provider-onboarding"}]}]},{"group":"DNS Concepts","icon":"server","pages":[{"title":"DNS Concepts","sidebarTitle":"Overview","href":"/dns-concepts"},{"title":"Handling DKIM, SPF, and DMARC Records","sidebarTitle":"DKIM, SPF and DMARC Records","href":"/handling-dkim-spf-dmarc-records"},{"title":"DMARC Handling: Advanced Options","sidebarTitle":"DMARC Advanced Options","href":"/advanced-dmarc-options"},{"title":"Provider Limitations","href":"/provider-limitations"}]},{"group":"Entri MCP","icon":"plug","pages":[{"title":"Overview","href":"/entri-mcp"},{"title":"Tool Reference","href":"/entri-mcp-tools"},{"title":"Build Your Own MCP Tools","sidebarTitle":"Build Your Own Tools","href":"/entri-mcp-custom-tools"}]},{"group":"Reference","icon":"book-open","pages":[{"title":"Webhooks Overview","href":"/webhooks-overview"},{"title":"Errors Overview","href":"/errors/overview"},{"title":"SSO and SCIM Provisioning","sidebarTitle":"SSO \u0026 SCIM","href":"/sso-and-scim-provisioning"}]},{"group":"Legal \u0026 Security","icon":"shield-halved","pages":[{"title":"Responsible Disclosure Policy","href":"/responsible-disclosure-policy"}]},{"group":"Resources","icon":"arrow-up-right-from-square","pages":[{"title":"Blog","icon":"newspaper","url":"https://www.entri.com/resources/blog","href":"/links/blog"},{"title":"Demo","icon":"presentation-screen","url":"https://www.entri.com/demo","href":"/links/demo"}]}]},"basePath":"","title":"Migrating to Entri Unify - Entri","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}