Merge pull request #220204 from csmulligan/csm-exid-code-sampleas-sssu

[EXID] Content freshness update for API invitation and samples

Author: v-regandowner

articles/active-directory/external-identities/code-samples-self-service-sign-up.md

@@ -5,18 +5,18 @@ services: active-directory
 ms.service: active-directory
 ms.subservice: B2B
 ms.topic: sample
-ms.date: 06/16/2020
+ms.date: 11/30/2022
 
 ms.author: mimart
 author: msmimart
 manager: celestedg
 ms.custom: "it-pro"
-ms.collection: M365-identity-device-management
+ms.collection: engagement-fy23, M365-identity-device-management
 ---
 
 # Samples for External Identities self-service sign-up
 
-The following tables provide links to code samples for leveraging web APIs in your self-service sign-up user flows using [API connectors](api-connectors-overview.md).
+The following tables provide links to code samples for applying web APIs in your self-service sign-up user flows using [API connectors](api-connectors-overview.md).
 
 ## API connector Azure Function quickstarts
 
@@ -40,3 +40,9 @@ The following tables provide links to code samples for leveraging web APIs in yo
 | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
 | [IDology](https://github.com/Azure-Samples/active-directory-dotnet-external-identities-idology-identity-verification) | This sample shows how to verify a user identity as part of your self-service sign-up by using an API connector to integrate with IDology. |
 | [Experian](https://github.com/Azure-Samples/active-directory-dotnet-external-identities-experian-identity-verification) | This sample shows how to verify a user identity as part of your self-service sign-up by using an API connector to integrate with Experian. |
+
+## Next steps
+
+- [Code and Azure PowerShell samples](code-samples.md)
+- [External Identities pricing](external-identities-pricing.md)
+

articles/active-directory/external-identities/customize-invitation-api.md

@@ -6,17 +6,18 @@ services: active-directory
 ms.service: active-directory
 ms.subservice: B2B
 ms.topic: how-to
-ms.date: 02/03/2021
+ms.date: 12/02/2022
 
 ms.author: mimart
 author: msmimart
 manager: celestedg
 
-ms.collection: M365-identity-device-management
+ms.collection: engagement-fy23, M365-identity-device-management
+# Customer intent: As a tenant administrator, I want to customize the invitation process with the API.   
 ---
 # Azure Active Directory B2B collaboration API and customization
 
-We've had many customers tell us that they want to customize the invitation process in a way that works best for their organizations. With our API, you can do just that. [https://developer.microsoft.com/graph/docs/api-reference/v1.0/resources/invitation](/graph/api/resources/invitation)
+We've had many customers tell us that they want to customize the invitation process. [With our API](/graph/api/resources/invitation), you can customize the invitation process in a way that works best for your organization.
 
 ## Capabilities of the invitation API
 
@@ -25,8 +26,8 @@ The API offers the following capabilities:
 1. Invite an external user with *any* email address.
 
     ```
-    "invitedUserDisplayName": "Sam"
-    "invitedUserEmailAddress": "gsamoogle@gmail.com"
+    "invitedUserDisplayName": "Taylor"
+    "invitedUserEmailAddress": "taylor@fabrikam.com"
     ```
 
 2. Customize where you want your users to land after they accept their invitation.
@@ -35,13 +36,13 @@ The API offers the following capabilities:
     "inviteRedirectUrl": "https://myapps.microsoft.com/"
     ```
 
-3. Choose to send the standard invitation mail through us
+3. Choose to send the standard invitation mail through us.
 
     ```
     "sendInvitationMessage": true
     ```
 
-   with a message to the recipient that you can customize
+   with a message to the recipient that you can customize.
 
     ```
     "customizedMessageBody": "Hello Sam, let's collaborate!"
@@ -57,15 +58,15 @@ The API offers the following capabilities:
 
    In this case, you get back a redemption URL from the API that you can embed in an email template, IM, or other distribution method of your choice.
 
-6. Finally, if you are an admin, you can choose to invite the user as member.
+6. Finally, if you're an admin, you can choose to invite the user as member.
 
     ```
     "invitedUserType": "Member"
     ```
 
 ## Determine if a user was already invited to your directory
 
-You can use the invitation API to determine if a user already exists in your resource tenant. This can be useful when you're developing an app that uses the invitation API to invite a user. If the user already exists in your resource directory, they won't receive an invitation, so you can run a query first to determine whether the already email exists as a UPN or other sign-in property.
+You can use the invitation API to determine if a user already exists in your resource tenant. This can be useful when you're developing an app that uses the invitation API to invite a user. If the user already exists in your resource directory, they won't receive an invitation, so you can run a query first to determine whether the email already exists as a UPN or other sign-in property.
 
 1. Make sure the user's email domain isn't part of your resource tenant's verified domain.
 2. In the resource tenant, use the following get user query where {0} is the email address you're inviting:
@@ -86,8 +87,7 @@ In this mode, whoever is using the API needs to have the permissions to be creat
 
 In app only context, the app needs the User.Invite.All scope for the invitation to succeed.
 
-For more information, refer to: https://developer.microsoft.com/graph/docs/authorization/permission_scopes
-
+For more information, see: https://developer.microsoft.com/graph/docs/authorization/permission_scopes
 
 ## PowerShell
 
@@ -128,6 +128,5 @@ Check out the invitation API reference in [https://developer.microsoft.com/graph
 ## Next steps
 
 - [What is Azure AD B2B collaboration?](what-is-b2b.md)
+- [Add and invite guest users](add-users-administrator.md)
 - [The elements of the B2B collaboration invitation email](invitation-email-elements.md)
-- [B2B collaboration invitation redemption](redemption-experience.md)
-- [Add B2B collaboration users without an invitation](add-user-without-invite.md)