Customer invitation

This page explains how to invite customers to create an account for themselves in your applications.

With customer invitations, you can take the first step towards your potential customers and offer them a shortcut to your sign-up journey. From there, the rest is up to them, but in hopes of driving up your conversion rate, you can spare customers some administrative tasks by pre-filling their profile information in the invite or allowing them to sign in with an external identity.

Stylized invitation sign-up form with pre-filled details

Stylized invitation sign-up form with pre-filled details

How to invite customers

You can find customer invites on the 'Account management' tab in the Admin Console. You can create a new invite form with the 'Invite customer' button on the right.

πŸ“˜

You can select your identity store on the left.

Invite customer button on the Account management page

Invite customer button on the Account management page

Invitation types

Invitations allow you to invite customers to specific organizations that segment user populations within the same identity store.

You can also get non-organizational users on board who will not be part of a specific customer segment.

🚧

OAuth 2.0 support

Only clients that are configured to use OAuth2/OIDC can use the customer invite feature. Invitation is not available for SAML2 clients at this moment.

πŸ“˜

Available clients

Clients define the entry and exit points of the customer flow. The list of available clients will change based on whether the invitation is for an organization or not. Organizations require special types of clients.

Invite to organization

If you invite a customer to an organization, then only clients that belong to organizational applications will be listed. Clients of non-organizational applications are not designed to handle organizational routing.

Invitation to organization

Invitation to organization

Invite non-organizational users

If you go with "No organization" in the Organization drop-down, then only clients that belong to non-organizational applications will be listed.

Invitation form

After you've set up where your customer's identity will live in the identity store, you can continue with filling out the invitation form.

Account invitation form

Account invitation form

Filling out the invitation form

Invite method

  1. You can add the email address where the invitation will be sent.

πŸ“˜

The email address where the invitation is sent can automatically become the identifier of the account if the identity store supports the 'EMAIL' identifier. You can restrict customers to the email address the invitation was sent to or allow them to use a different email address as an identifier. Learn how to configure allowing a different email address.

  1. You can also specify in advance the default language of the profile.

πŸ“˜

Language selection

UI elemenents and your branding communications, such as the contents of your notifications (in this case, the account invitation message) will appear in the selected language for your invitee, provided you've added a translation package for that language. You can learn more about how you can get translatable contents out of the Admin Console at the link.

🚧

Sending error

You will run into an error while trying to send an invitation if

  • the invite method field is set to read-only in the application's self-service policy AND
  • the email address you provide in the invitation form is already tied to an existing customer identity in the current identity store

Invite customer to

  1. You can select the organization to invite the customer to, or you can go without selecting an organization altogether.
  2. You can select a client where invitees can finalize their invitations and experience your branding.

Assign customers to

  1. You can assign a Role to an invitee.
  2. You can add an invitee to a Group inside the identity store.

πŸ“˜

The customer identity will be placed in the selected group(s) after account creation.

🚧

Identities invited to the application are also automatically added to every group assigned to the application. If there are more groups assigned to the application than you include in the invitation, the customer identity will be added to the additional groups as well. You can manage group memberships afterwards.

Personal information

  1. You can fill in the profile information of the new account.

βœ…

When accepting the invitation, invitees can double-check the information (in fields made available to them during registration) that goes in their profiles before accounts are created.

After send

Once you're finished, you can click 'Send invite' to deliver the invitation to your customer.

An entry will be created for the invitee. You can track the invitation's status:

Pending invitation

Pending invitation

βœ…

If the customer accepts the invitation and completes sign-up, the invitation's status will change from 'Pending' to 'Done', and the account will be listed in the 'Accounts' tab.

While waiting for the customer's response, you can enter the detailed view of the invitation where you can:

  • Resend the invitation
  • View the details
  • Revoke the invitation
Pending invitation detailed view

Pending invitation detailed view

πŸ“˜

Revoked invitations are removed from the 'Invitations' list permanently.