Link Users

Read about linked users so that you understand the concept and its limitations before continuing on this more developer focused documentation.

Create linked users

By invitation

Add query string parameter link=true to the invitation link will trigger a flow where the user must sign-in with (or create) a personal account which will do the linking automatically.

By API calls

To create users that should be linked you do the same as for a regular user. After the user is created, it is possible to link the user to a parent by POST users/{newly created user id}/link/{parent user id}.

Events during linking

A UserClaimAdded event is raised when a user is linked to a parent user. The event is raised to the child user (the same user that the link API was used for), which means that the AggregateId will have the value of the child user. The ClaimType will be “sub” and the ClaimValue will have the unique identifier of the parent user.