Add a self-service sign-up user flow to an app

Tip

This article applies to B2B collaboration user flows. If your tenant is configured for customer identity and access management, see Create a sign-up and sign-in user flow for customers.

For applications you build, you can create user flows that allow a user to sign up for an app and create a new guest account. A self-service sign-up user flow defines the series of steps the user follows during sign-up, the identity providers you allow them to use, and the user attributes you want to collect. You can associate one or more applications with a single user flow.

Note

You can associate user flows with apps built by your organization. User flows can't be used for Microsoft apps, like SharePoint or Teams.

Before you begin

Add identity providers (optional)

Microsoft Entra ID is the default identity provider for self-service sign-up. This means that users are able to sign up by default with a Microsoft Entra account. In your self-service sign-up user flows, you can also include social identity providers like Google and Facebook, Microsoft Account, and the email one-time passcode feature. For more information, see these articles:

• Add Google to your list of social identity providers
• Add Facebook to your list of social identity providers
• Add Microsoft account as an identity provider
• Email one-time passcode authentication

Define custom attributes (optional)

User attributes are values collected from the user during self-service sign-up. Microsoft Entra External ID comes with a built-in set of attributes, but you can create custom attributes for use in your user flow. You can also read and write these attributes by using the Microsoft Graph API. See Define custom attributes for user flows.

Enable self-service sign-up for your tenant

Tip

Steps in this article might vary slightly based on the portal you start from.

Before you can add a self-service sign-up user flow to your applications, you need to enable the feature for your tenant. Then controls become available that let you associate the user flow with an application.

Note

This setting can also be configured with the authenticationFlowsPolicy resource type in the Microsoft Graph API.

1. Sign in to the Microsoft Entra admin center as at least a User Administrator.

2. Browse to Identity > External Identities > External collaboration settings.

3. Set the Enable guest self-service sign up via user flows toggle to Yes.

   

4. Select Save.

Create the user flow for self-service sign-up

Next, you create the user flow for self-service sign-up and add it to an application.

1. Sign in to the Microsoft Entra admin center as at least a User Administrator.

2. Browse to Identity > External Identities > User flows, and then select New user flow.

   

3. Select the user flow type (for example, Sign up and sign in).

4. Select the version (Recommended or Preview), and then select Create.

5. On the Create page, enter a Name for the user flow. The name is automatically prefixed with B2X_1_.

6. In the Identity providers list, select one or more identity providers that your external users can use to log into your application. (See Before you begin earlier in this article to learn how to add identity providers.)

7. Under User attributes, choose the attributes you want to collect from the user. For more attributes, select Show more. For example, select Show more, and then choose attributes and claims for Country/Region, Display Name, and Postal Code. Select OK.

   

   Note

   You can only collect attributes when a user signs up for the first time. After a user signs up, they will no longer be prompted to collect attribute information, even if you change the user flow.

8. Select Create.

9. The new user flow appears in the User flows list. If necessary, refresh the page.

Select the layout of the attribute collection form

You can choose order in which the attributes are displayed on the sign-up page.

1. Sign in to the Microsoft Entra admin center as at least a User Administrator.
2. Browse to Identity > External Identities > User flows.
3. Select the self-service sign-up user flow from the list.
4. Under Customize, select Page layouts.
5. The attributes you chose to collect are listed. To change the order of display, select an attribute, and then select Move up, Move down, Move to top, or Move to bottom.
6. Select Save.

Add applications to the self-service sign-up user flow

Now you associate applications with the user flow to enable sign-up for those applications. New users who access the associated applications are presented with your new self-service sign-up experience.

1. Sign in to the Microsoft Entra admin center as at least a User Administrator.

2. Browse to Identity > External Identities > User flows

3. Select the self-service sign-up user flow from the list.

4. In the left menu, under Use, select Applications.

5. Select Add application.

   

6. Select the application from the list. Or use the search box to find the application, and then select it.

7. Choose Select.

Next steps

• Add Google to your list of social identity providers
• Add Facebook to your list of social identity providers
• Use API connectors to customize and extend your user flows via web APIs
• Add custom approval workflow to your user flow