Add SSO connection via self-serve portal
Auth and access
You can configure a self-serve portal to enable authorized organization members to be able to self-manage functions provided by Kinde. Authorized org members can update:
A self-serve portal means your customers can make account changes without contacting you for support. This can save you both time.
If you are on the Kinde Scale plan, you can configure the portal per organization. E.g. allow some functions for some customers and not others.
Go to Settings > Environment > Self-serve portal.
Enter the Return URL that you want users to land on when they exit the portal, e.g. your app dashboard.
Add an Organization alias to represent how your customers are referred to in your business, e.g. Account, Partner, Workspace, etc. This will be visible in the interface in the portal.
In the Organization self-management section, select the functions you want organization admins to be able to manage.
Select Save.
Each core function within the self-serve portal is governed by a corresponding system permission. For example, the org:write:billing permission allows users to update payment methods and billing information. org:read:billing lets them view those details without changing them.
When Roles is enabled under Organization self-management, org:read:roles lets members view the organization’s roles and permissions in the portal, and org:write:roles lets them create, edit, and delete them. The Kinde-managed owner role includes both. See Let members manage organization roles from the portal.
These permissions can be included in your custom roles and assigned to organization members.
We recommend creating custom roles with varying levels of portal access, which you can then assign as needed. For instance, you might create a role that allows members to view billing details but not update them. You can select these permissions within your existing roles, or when you create them.
When configuring org roles, you can specify whether it should be:
On Payment details, members with billing access see:
Payment method — saved cards, Add card, set default, remove
Billing information — name, email, phone, description, address, and tax IDs
Members with org:write:billing can select Edit to open Edit billing information. They can update:
Select Save.
This is the Stripe customer Bill-to data used on invoices. It is separate from Business details in the portal, which is the organization’s profile name.
Right after checkout, Stripe may still be syncing. The portal can show: We are still setting up your payment and billing information. This page updates automatically when it is ready. Edit and Add card stay unavailable until that finishes.
Turn on Members under Organization self-management in Settings > Environment > Self-serve portal. The switch is off until you select it.
Authorized members can then invite other people into their organization directly from the portal, without you adding users manually or via the API.
Member invitations must also be enabled at the environment level. Go to Settings > Environment > Policies, switch on Allow invitations, and choose the Invite application that invitation links should open. Allow invitations is off until you switch it on. See Set global access policies.
A member can view invitations, invite others, and revoke pending invitations only with the matching system permission:
org:read:members permission to view pending invitations.org:write:members permission to open the Add member flow and send an invitation. Revoke invitation is shown only when the member has this permission.Open the organization portal and go to Members.
Select Add member.
Enter the new member’s First name, Last name, and Email.
Select the Roles the member will have in the organization.
Select Save.
The person receives an email invitation to join the organization. They can set up a new account or sign in to an existing one to accept. For more on what the invitee sees, see Invited user sign-up experience.
Pending invitations appear in an Invitations list on the Members screen, showing each invitee’s name, email, role, and the date invited. Revoke invitation is shown only to members with the org:write:members permission.
If invitations are disabled for the environment, the Add member option and the Invitations list are hidden in the portal when members browse Members normally. A bookmarked or direct URL to the add-member screen still loads that page and shows an “Invitations are disabled” message instead of the invite form.
Authorized members can create roles and permissions that belong only to their organization, and assign those roles to members, without contacting you.
Turn on Roles under Organization self-management, then select Save. The switch is off until you select it, and the change only takes effect once the settings are saved.
Also enable Members if it is not already on, so admins can assign the roles they create. Assigning roles from Members requires the org:write:members permission. To assign roles while inviting members, allow invitations for the environment as well.
Organization-managed roles are available on the Kinde Scale plan.
See Let organizations manage their own roles for how this works.
Access to the portal is granted via a one-time link. You then use the link on an ‘account’ or ‘profile’ button in your app to open the Kinde portal screens.
You can generate the link using the user’s access token (recommended).
This method is ideal when you want to generate the portal link on the fly—for example, when a user clicks an “Account” button in your app.
If you’re using the Kinde React SDK, you can use the <PortalLink /> component, which both generates the link and redirects the user:
import {PortalLink} from "@kinde-oss/kinde-auth-react";
<PortalLink>Account</PortalLink>;If you’re not using a Kinde SDK, you can manually call the Account API:
const response = await fetch("/account_api/v1/portal_link", { headers: { Authorization: `Bearer ${userAccessToken}` }});const data = await response.json();window.location = data.url;Optional parameters:
return_url – where to redirect the user after exiting the portal.subnav – specify the portal section to open. See Get self-serve portal link for the supported values.When the user clicks the link you’ve added to your app, the portal opens. The default design is shown below, and we are working on allowing you to style this yourself. The options a member sees depends on their role and what you have chosen to display.