# Organizations

Your first Mindee account is a personal account: you cannot invite any member to join it.

To do so, you need to create an organization.

Users can create multiple organizations, making it easier to track how the APIs in that organization are being used, manage members, and handle billings for each organization.

From the **Organizations** overview page, for the organizations you are admin, you will be able to oversee and manage members in those organizations, APIs, and billing across the different organizations.

## Creating an Organization

To create an organization from your account

1. Go to your [Settings dashboard](https://docs.mindee.com/v1/account-settings#accessing-your-settings-dashboard) and click on **Organization**
2. On the Organization overview page, click on the \*\*Create organization \*\*button.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-0d1c21795d5c08d840f0ff0c53ffcdd569ec914c%2F155e728-org.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

2. Set up the Organization by filling in the following information: **Organization account name**, **Legal name**, **Alerting email**, and **Invoicing email**.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-dd251805e7705e7d1bdf0c3332622a8c61668536%2F0b15bb9-Screenshot_2022-07-13_at_13.07.01.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3. Click on the \*\*Create organization \*\* button as seen above. Your added organization will be visible on the organization overview page.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-0c2f3ca208a276ca52f754a66357d207b7297f46%2F996a0c923590cb809c359582f09364f78c36d6abe34359e5e3957a28e2e75a85-image.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

## Accessing the Organization Overview Page

You can create multiple organization accounts in Mindee. You can also switch from one organization to another or leave an organization as well as invite members to your organization.

To switch to another organization and access the organization settings overview page.

1. Click on the **Switch** button from the organization's overview page.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-c8a4b7216b96f865ea15f2ab4491409a7b4f954c%2F8e495a23117cd3a077144e2798b97ba7cccd6ccb6ce18bc3b52de51fb9143325-image.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

2. You'll land on the organization's APIs hub. Click on the organization name at the top right side of the page and click on **Settings**.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-1ed6ae9b270730902c528f7b92e83dbbf82bfba6%2F77d1123d501200be681114777d29bbeb89a6447d56651b1ee37409b4aae11836-image.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
You can switch between organization accounts by clicking on the organization name from the drop-down.
{% endhint %}

3. You'll land on the organization overview page.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-ce4933ffa087a9d927f79dbb8f3a56df9162d0d6%2F0f01e1b-762542a-Screenshot_2022-05-10_at_11.56.32.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

## Editing Organization Account Profile

In the **Account** overview page of your created organization settings dashboard, you can edit the following:

* Legal name
* Alerting email
* Invoicing email

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-09f3a7e2776eef84d501818307f1cbcda105d32a%2F3f6c6fc-b57fb95-Screenshot_2022-05-10_at_12.06.30.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Once changes have been made to these fields, click on **Save changes.** If you do not approve of the changes, click on **Discard changes**.

## Managing Organization Members

When you have created your organization you can perform the following actions:

* [Add member to your organization](#adding-members-to-your-organization)
* [Updating member role and details](#updating-member-role-and-details)
* [Remove member from your organization](#removing-a-member-from-the-organization)

### Adding Member to your Organization

From your organization settings dashboard, you can invite and add members to your organization from the Members overview page.

1. Go to the **Members** section and click on the \*\*Add a member \*\*button.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-d3b71bc5493b8dff309b75dc20dd108881ec983f%2F2d34ce0-0f07847-Screenshot_2022-05-10_at_12.04.04.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

2. Add the email address of the member.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-0e972be76afa2e92d1bdd1c21edd81c935b5ce12%2Fb2b8653-Screenshot_2022-07-13_at_13.12.47.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3. Select the role you want to give the member either *Admin* or *member* role.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-6cf08436dfeddcd7f539a6b4ee768a9c4e00542c%2F44313db-Screenshot_2022-07-13_at_13.14.09.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

4. Once the fields have been filled click on the **Add a member** button.

You'll receive a pop-up notification that your invitation has been sent. The invited member will also receive an email with an invitation.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-e49245368afeb2712bd99fdb266d9f3df6596f7f%2F487bd33-Screenshot_2022-05-10_at_12.21.39.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Once the invited member accepts the invitation, they will have access to APIs details from the organization. The **Members** overview page will also be updated.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-421a0d8ed42890bf67f65bb9766a325465963895%2F3fdabb1-Screenshot_2022-05-10_at_12.54.51.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

### Updating Member Role and Details

You can only update the permission of members who have the **Member** role in your organization. You can give an **Admin** role to these members. To do so:

1. Click on the **Edit** icon

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-fd601b2fc94899f86258efed380e267621bbfaec%2Fe662172-Screenshot_2022-05-10_at_13.25.36.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

2. Edit your member's details by selecting the role you want to assign your member with from the drop down.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-1ba391e5659e163cf3b95110ff541db1a0db422e%2Ff1d04dd-Screenshot_2022-07-13_at_13.18.10.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3. Click on **Save changes**.

Your member's role will be updated in the **Members** overview page.

{% hint style="info" %}
You cannot change a member's email directly, you can however remove the member from your organization, and add the member back with the right email.
{% endhint %}

To update member permission from **Admin** role to **Member** role. You'll need to contact the support team.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-fe72835b86c49d5ffeda615d89711a7fb4be5c66%2Fc50bebb-7c225fd-Screenshot_2022-05-20_at_18.20.22.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

### Removing a Member From The Organization

To remove a member from your organization.

1. Click on the \*\*delete \*\* icon.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-9ecfeca5669aecbfd33f11763a7f0986e7f1ddf5%2Fb698b2c-Screenshot_2022-05-10_at_13.25.45.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

2. Type the email address to confirm the removal of the member.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-0435a22a478c3430fbcb9e934dea1d70c68e3c7e%2F3c16d3f-Screenshot_2022-07-13_at_23.49.05.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3. Click on the **Remove member** button.

The member will be removed from your account and your **Members** overview page will be updated.

{% hint style="info" %}
To remove members who have admin roles, you'll have to contact the support team.
{% endhint %}

## API Keys Management

At the organizational level, you can create and manage your API keys. These API keys can be accessed by members of your organization. For a detailed guide on how to create your API keys, see [Create and Manage API keys](https://docs.mindee.com/v1/get-started/create-api-key)

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-ee59ef60fccd3a996932bee9d09041b12bc2b426%2Fedf1013-Screenshot_2022-07-13_at_23.43.50.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

## Leaving an Organization

{% hint style="warning" %}
Once this action is carried out, you'll no longer have access to the organization.
{% endhint %}

To leave an organization:

1. Click on the \*\*Leave organization \*\* button from the \*\*Organizations \*\* overview page.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-708bf69c5543b3cc05917d7a343f4bbf1e1d7b0a%2Fd519735-f97852f-Screenshot_2022-05-10_at_11.19.58_1.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

2. Type the organization name to confirm.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-90942af647de5cae5b4c69ec7a8a0708ab2ec73d%2Fc98b8e7-Screenshot_2022-07-13_at_13.21.55.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3. Click on the **Leave organization** button.
