Skip to main content

​
What this is

Each flow has a platform host. When you create a magic link, the url is {flow-host}/{linkId}. If you want that host to be yours (https://enviar.yourbrand.com), declare a custom domain per flow. We mint new links on that base URL. DNS, TLS, and the reverse proxy are yours — we do not issue certificates or verify domain ownership.

​
What you must proxy

Point your hostname at the platform host shown for that flow in Partner Portal → Settings → Flow domains. The proxy must:
  1. Preserve the path (/{linkId} and any other widget routes)
  2. Serve the flow’s config.js unmodified
config.js includes FLOW_SLUG (which flow this is) and API_BASE_URL (which backend the widget calls). Rewriting either breaks the widget or fails verification.
Read the platform default URL from Partner Portal. Do not hardcode widget hosts from this page — they change by environment.

​
How to configure

  • Partner Portal: Settings → Flow domains. Enter an https base URL (no query string). Save, then Verify.
  • API: PUT /partner/settings with a complete flowDomains map ({ "smart": "https://enviar.yourbrand.com" }). Send null or "" to clear a slug.
Host: Partner API overview.

​
Verification

We GET {your-domain}/config.js and compare FLOW_SLUG to the catalog slug. Verification is an operational signal. An unreachable domain can still be saved (you may still be propagating DNS). flow_mismatch blocks the save. Changing a domain does not rewrite magic links already created. Only new POST /partner/links (and other mint paths) use the override.

​
Next steps

Magic links

How the url is built.

Create links

Mint a link after the domain is set.