Sharing Link Custom Domain
Enterprise tier only
app.goentri.com base URL in sharing links with a custom, branded domain. This creates a seamless white-labeled experience for the end users receiving and completing the shared flow.
Default sharing link:
Configuration
Configure your sharing link custom domain in the Entri Dashboard:- Go to Account Settings → Application Settings
- Locate the Sharing link URL field
- Enter your desired base URL (e.g.,
https://domains.yourbrand.com) - Save your changes
Your custom domain must be set up to point to Entri. The required DNS configuration depends on whether you’re using a subdomain or a root domain:
- Subdomain (e.g.,
domains.yourbrand.com): add aCNAMErecord pointing tosharing.goentri.com. - Root domain (e.g.,
yourbrand.com): add the followingArecords (noAAAArecords are required):15.197.212.2043.33.229.73
sharing_link_url setting is automatically applied to all sharing links generated for that application — no code changes are needed on the frontend.
Effect on the Sharing Links API
When a custom domain is set, thelink field returned by the Sharing Links API will automatically reflect your custom domain instead of app.goentri.com:
Using with entri.loadSharedFlow()
Pass the full custom-domain URL directly to entri.loadSharedFlow() — no additional configuration is needed:
Webhook Notifications
When your users go through an Entri flow, Entri sends webhook notifications to keep your backend informed about flow progress and outcomes. To learn more about webhook configuration and delivery, visit our webhook documentation page.Correlating Shared / Derived Flows
Some platforms allow users to share a flow (for example, sending a link to another person). When that shared link is used, the resulting run is considered a derived flow. To help you correlate the derived flow back to the original one, Entri supports propagating anorigin_flow_id value into webhook events.
How it works
- If a flow is initialized with
origin_flow_idin its configuration, Entri stores that value on the created flow. - For every webhook event emitted for that flow, Entri includes the stored value as
origin_flow_id. - If
sharedFlowIdwas not provided when the flow was created, webhook payloads will not includeorigin_flow_id.
origin_flow_idis propagated as-is (no lookup, validation, or mutation).- This is a non-breaking change: existing webhook fields remain unchanged, and
origin_flow_idis optional.
Webhook payload example
Shared flows and sharing link domains
When a user completes an Entri flow that was initiated via a sharing link, Entri fires webhook events just like any standard flow. A few things to keep in mind:- The
job_idreturned when the sharing link was created is the identifier used to correlate all webhook events for that flow. It remains consistent regardless of whether a custom sharing link domain is configured — the domain only affects the URL of the link itself, not the webhook payload. - To retrieve the last webhook event for a shared flow, use the Get last webhook by job ID endpoint with the
job_id. - If the flow was initiated with a
sharedFlowId, webhook events for the derived flow will include anorigin_flow_idfield. See Correlating Shared / Derived Flows for details.
Sharing links API
The Sharing Links API allows users to securely hand off an ongoing Entri flow, such as Connect or Sell, to another person for completion. This is particularly useful when the current user does not have the required DNS credentials (in Entri Connect) or payment information (in Entri Sell). By generating a sharing link, you can let a colleague, client, or administrator pick up exactly where the flow was left off and complete the process without starting over. For Enterprise plan integrations, the sharing link URL can be white-labeled to use your own custom domain. See Sharing Link Custom Domain for configuration details.Entri Connect
Request body
JSON
Successful response (200 status)
JSON

