Microsoft Entra External ID
Authentication

Custom URL Domains

In brief

Native Authentication API V2 requires a tenant-verified custom domain for browser-based apps such as SPAs, while non-browser iOS and Android clients using native HTTP transports do not require one.

What Entra admins need to know

Verify and configure a tenant-verified custom domain for browser-based integrations; native mobile clients do not need this configuration.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

title: Custom URL Domains description: Learn when a custom URL domain is required and how it routes authentication requests for your Microsoft Entra External ID applications. ms.topic: concept-article ms.date: 11/11/17/2026 ms.custom: it-pro, sfi-image-nochange, msecd-doc-authoring-1030 ai-usage: ai-assisted #Customer intent: As a dev, devops, or it admin, I want to learn about personalizing my application’s sign-in endpoints with my own branding or naming instead of Microsoft’s default domain name by using a custom URL domain.

[!INCLUDE authentication-approaches]

The current Native Authentication API V2 requires a tenant-verified custom domain for browser-based apps, such as single-page applications (SPAs), to help protect against cross-site request forgery (CSRF). Non-browser clients, such as iOS and Android apps using native HTTP transports, don't require a custom domain. Bring Your Own UX (BYO UX) requireremains browser-based and requires a tenant-verified custom domain for allits service API call URLs.calls. Verify and configure thatthe domain before integrating eithera browser-based approach. Microsoft-hosted authentication can also use a custom URL domain for a consistent sign-in address.

:::image type="content" source="./media/concept-custom-url-domain/custom-domain-user-experience-small.png" alt-text="Screenshot demonstrates an External ID custom URL domain user experience." lightbox="./media/concept-custom-url-domain/custom-domain-user-experience.png":::

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…