> ## Documentation Index
> Fetch the complete documentation index at: https://tyk.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Organizations

> How to manage organizations in Tyk developer portal

## Introduction

Quite often, API Providers have to provide API Products to other companies. In fact, 90% of our customers say that their primary audience is other companies. In this case, they are dealing with not just individual developers but with teams of developers.
Unlike individual developers, companies require more sophisticated machinery to access API credentials:

* Usually, a company is represented by a team of developers, not just an individual. Communication between API Providers and API Consumers mustn’t rely on a single individual that may leave a company or be fired;
* API Consumers need to share access credentials securely within their team. Without that capability, they have to share credentials with internal communication tools, which is a horrible practice. Credentials may be stolen, exposed to an incorrect audience, or not appropriately updated;
* Those teams have an internal hierarchy: some users have admin responsibilities with broader permissions, while other teammates’ permissions are restricted to only accessing API Credentials;
* API Consumers should be able to maintain their teams by themselves: invite new members or remove ones that left the team.

So, simply put, there are two main challenges that the new API Consumer organization management capability solves:

* How to share securely share access credentials between team members;
* How to manage user permissions on the API consumer side.

**Prerequisites**

Before starting, you need to set up an email server because it’s used to send invitations to API Consumer team members.
Please refer to the email notifications documentation to set up the email server.

Please refer to the [email notification section](/5.8/product-stack/tyk-enterprise-developer-portal/getting-started/setup-email-notifications) for further instructions for setting up the email server.

## Admin Settings and Governance

You can control if API Consumers can register an organization and if such registration requires approval from the portal admins.
To enable API Consumer organization registration, navigate to the Settings/General menu and scroll to the API Consumer access section. In that section, there are two settings that control API Consumer registration:

* **Enable API consumers to register organizations**: when this setting is enabled, API Consumers can register organizations, and the respective button appears in the navigation menu;
* **Auto-approve API consumers registering organization**: When this setting is enabled, no approval is required from the portal admins for an API Consumer to register an organization. If this setting is disabled, API Consumer can register organizations, but they won’t be able to invite team members.

<br />This is how it looks in the portal's UI:

<img src="https://mintcdn.com/tyk/RUEpCcfQ3zk4RxhB/img/dashboard/portal-management/enterprise-portal/api_consumer_org_registration_settings.png?fit=max&auto=format&n=RUEpCcfQ3zk4RxhB&q=85&s=be1628ef0e9c5bd619c14ba523603de1" alt="Organization registration settings" width="3024" height="1530" data-path="img/dashboard/portal-management/enterprise-portal/api_consumer_org_registration_settings.png" />

<br />To proceed with the following steps, enable the Enable API consumers setting to register organizations.

## Self Registration

**Steps for Configuration**

1. **Request org registration**

   Register a developer account or use an existing one and log in to the developer portal as a developer.
   To start the organization registration flow, click on the **Create an organization** button in the top right corner of the screen.

   <img src="https://mintcdn.com/tyk/RUEpCcfQ3zk4RxhB/img/dashboard/portal-management/enterprise-portal/become_an_organisation_navbar.png?fit=max&auto=format&n=RUEpCcfQ3zk4RxhB&q=85&s=222e8b82d27c409881324871dc3b2011" alt="Become an organization button" width="3024" height="1494" data-path="img/dashboard/portal-management/enterprise-portal/become_an_organisation_navbar.png" />

   <br /><br />You will be navigated to the screen where you can specify the name of your future organization.

   <img src="https://mintcdn.com/tyk/B97_xetnHOB2KQMe/img/dashboard/portal-management/enterprise-portal/specify_name_of_an_organisation.png?fit=max&auto=format&n=B97_xetnHOB2KQMe&q=85&s=83972870574b81a1b1673efafd418847" alt="Specify name of the organization" width="3022" height="1498" data-path="img/dashboard/portal-management/enterprise-portal/specify_name_of_an_organisation.png" />

   <br /><br />If the **Auto-approve API consumers registering organization** setting is enabled, the new organization will instantly be provisioned.

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/org_registration_is_approved.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=08a9d632e7081ab92e7515f4097c17eb" alt="Organization registration is approved" width="3024" height="1496" data-path="img/dashboard/portal-management/enterprise-portal/org_registration_is_approved.png" />

   <br /><br />Otherwise, the developer will have to wait for approval from admin users.

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/org_registration_is_pending.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=9d6abfda9ac76c071da45acd946991e7" alt="Organization registration is pending" width="3024" height="1494" data-path="img/dashboard/portal-management/enterprise-portal/org_registration_is_pending.png" />

2. **Approve or reject organization registration requests**

   If the **Auto-approve API consumers registering organization** setting is disabled and the email settings are configured correctly, the admin users will be notified about the new organization registration request via email.

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/new_org_request_email.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=b3b7b43a5ca14090e4d915a00f20b974" alt="New organization registration request notification" width="2486" height="418" data-path="img/dashboard/portal-management/enterprise-portal/new_org_request_email.png" />

   <br /><br />If the **Auto-approve API consumers registering organization** setting is disabled, the new API Consumer organizations won’t be immediately provisioned.
   As an admin user, you can approve or reject organization registration requests from the Organization menu.

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/pending_org_registration_admin.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=a0ddb6a85cc3f35d425b0cf6eef28677" alt="New organization registration request view" width="3024" height="1562" data-path="img/dashboard/portal-management/enterprise-portal/pending_org_registration_admin.png" />

   When admin users approve or reject organization registration requests, the respective email notification is sent to API Consumers.

   Notification when organization request is approved:

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/org_request_approved_email.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=f6b288eeee8c5329a668d8d379ff3c8d" alt="Organization registration request is approved" width="2500" height="562" data-path="img/dashboard/portal-management/enterprise-portal/org_request_approved_email.png" />

   <br /><br />Notification when organization request is rejected:

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/org_request_rejected_email.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=6c8b2ce2cfe2bf0b4a3ee6dc885ad3e2" alt="Organization registration request is rejected" width="2500" height="554" data-path="img/dashboard/portal-management/enterprise-portal/org_request_rejected_email.png" />

   <br /><br />Both emails are customizable. Refer to [the email customization documentation](/5.8/portal/customization/email-notifications) for further information on the email customization.

3. **Invite or remove teammates**

   Once admin users approve the organization registration request, API Consumers can invite teammates.
   As an API Consumer, navigate to the Dashboard to invite new teammates.

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/navigate_to_dashboard.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=def3d4317a4c267cd2dac273b46d85cf" alt="Navigate to the dashboard" width="3024" height="1444" data-path="img/dashboard/portal-management/enterprise-portal/navigate_to_dashboard.png" />

   <br /><br />Then select the Users tab in the side menu.

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/open_users_tab.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=ab92b027b8f49d816e376bf8368f2f6c" alt="Navigate to the Users tab" width="3024" height="1488" data-path="img/dashboard/portal-management/enterprise-portal/open_users_tab.png" />

   <br /><br />You can add a new team member to your API Consumer organization in the Users tab. To invite a new team member, specify their first and last name, email address, and role.

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/invite_team_member.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=fbaee538749718cc1b8edb3ac509112a" alt="Invite new team member" width="3024" height="1492" data-path="img/dashboard/portal-management/enterprise-portal/invite_team_member.png" />

   <br /><br />There are two possible roles for API Consumers:

   * Super admin;
   * Team member.

   The difference between these two roles is that the Super admins can invite or remove users from their organization and manage applications, while the Team members can only manage applications.

   <br /><br />Once the invitation is sent, the invited team member should receive the following email:

   <img src="https://mintcdn.com/tyk/B97_xetnHOB2KQMe/img/dashboard/portal-management/enterprise-portal/team-member-invitation-email.png?fit=max&auto=format&n=B97_xetnHOB2KQMe&q=85&s=80fe7bd11bd2d4ff631f77425098df2d" alt="Invite new team member email" width="2484" height="640" data-path="img/dashboard/portal-management/enterprise-portal/team-member-invitation-email.png" />

   <br /><br />The invited team member can use the link from the email to register in the portal and join the organization.

   <img src="https://mintcdn.com/tyk/B97_xetnHOB2KQMe/img/dashboard/portal-management/enterprise-portal/register-new-user.png?fit=max&auto=format&n=B97_xetnHOB2KQMe&q=85&s=480500e926ac0fb9a5b1fe0a2b57ee10" alt="Invite new team member email" width="3024" height="1568" data-path="img/dashboard/portal-management/enterprise-portal/register-new-user.png" />

4. **Manage API Consumers' role**

   API Consumer Super admins can manage users in their organizations. To do so, navigate to the Users menu in the Dashboard and select a user to edit.

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/edit_api_consumer.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=559be0d3b89893c3417dba0734e708c0" alt="Edit API Consumer profile" width="3024" height="1480" data-path="img/dashboard/portal-management/enterprise-portal/edit_api_consumer.png" />

   <br /><br />As a Super admin, you can change users’ first and last names and roles. The changes will take effect immediately.

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/manage_api_consumer_profile.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=87b369374727bd76fc466fd4edbd0cb8" alt="Manage API Consumer profile" width="3024" height="1482" data-path="img/dashboard/portal-management/enterprise-portal/manage_api_consumer_profile.png" />

5. **Sharing assets between teammates**

   Now, when any team member creates an application, all other team members can access it and use the credentials.

   <img src="https://mintcdn.com/tyk/B97_xetnHOB2KQMe/img/dashboard/portal-management/enterprise-portal/share_credentials_between_api_consumers.png?fit=max&auto=format&n=B97_xetnHOB2KQMe&q=85&s=0f40245f7176bdb9a2415af3013bd7e4" alt="Share credentials between API Consumers" width="3024" height="1570" data-path="img/dashboard/portal-management/enterprise-portal/share_credentials_between_api_consumers.png" />

## Manually Create Organizations

In this section, you’ll learn how to create a new organization for your external API Consumers.

**Prerequisites**

* A Tyk Enterprise portal installation
* A portal admin app login

**Step by step instructions**

1. From the **API Consumers > Organizations** menu, click **Add**.

   <img src="https://mintcdn.com/tyk/p6VDuboOnNxaT_QZ/img/dashboard/portal-management/enterprise-portal/organisations-menu.png?fit=max&auto=format&n=p6VDuboOnNxaT_QZ&q=85&s=72192bc8a32ea6b9975b9d6126cafea4" alt="Portal Organizations menu" width="200" height="171" data-path="img/dashboard/portal-management/enterprise-portal/organisations-menu.png" />

   <img src="https://mintcdn.com/tyk/wHLHFqRiMZq91WJo/img/dashboard/portal-management/enterprise-portal/add-org2.png?fit=max&auto=format&n=wHLHFqRiMZq91WJo&q=85&s=bd21654e01302984960974c63bc4589f" alt="Add a new Organization" width="1958" height="502" data-path="img/dashboard/portal-management/enterprise-portal/add-org2.png" />

2. Enter the name of your new organization

   <img src="https://mintcdn.com/tyk/wHLHFqRiMZq91WJo/img/dashboard/portal-management/enterprise-portal/add-orgs.png?fit=max&auto=format&n=wHLHFqRiMZq91WJo&q=85&s=69f962283a7b52bc5d971f816f27f205" alt="Add a new Organization" width="666" height="623" data-path="img/dashboard/portal-management/enterprise-portal/add-orgs.png" />

3. Click **Save** to create your new organization. A new default-team will also automatically created that is tied to your new organization.

   <Note>
     If you want to edit the default team name you can do so by navigating to **Teams**, open up the team associated with the organization you created and edit the name as required.
   </Note>
