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

# Users & Permissions

> Learn how to invite users to your organization, manage their permissions, and lock or unlock them.

## Invite Users

You can invite an unlimited number of users to your organization.

To invite users to your organization, follow these steps:

<Steps>
  <Step title="Open the Settings">
    Go to [Settings > Users](https://app.fynn.eu/settings/users)
  </Step>

  <Step title="Add a new user by clicking the + symbol">
    <Frame>
      <img src="https://mintcdn.com/fynnsubscriptionbilling/iVIPUuF_nH0B0-xL/images/add-tenant-user.png?fit=max&auto=format&n=iVIPUuF_nH0B0-xL&q=85&s=7cdacdbbdb063041d416f9e97c5a2ea5" width="1678" height="1167" data-path="images/add-tenant-user.png" />
    </Frame>
  </Step>

  <Step title="Select the user's role">
    Choose between the roles `Administrator`, `Employee`, and `Read-only`.

    * `Administrator`: Has read and write access to all features and resources, as well as to the settings.
    * `Employee`: Has read and write access to all features and resources, but no access to the settings.
    * `Read-only`: Has only read access to all resources.
  </Step>

  <Step title="Click on Invite User" />
</Steps>

The user will then receive an email invitation to register with your organization using a password.

## Remove User Invitation

To remove a user invitation from your organization, follow these steps:

<Steps>
  <Step title="Open the Settings">
    Go to [Settings > Users](https://app.fynn.eu/settings/users)
  </Step>

  <Step title="Click on the trash icon next to the user invitation you want to remove" />

  <Step title="Click on the trash icon to remove the user invitation">
    The action must then be confirmed.

    <Note>
      The invitation will be removed from your organization and the user will no longer be able to register.
    </Note>
  </Step>
</Steps>

## Permissions

Fynn comes with three default roles that you can use for your users. These roles are:

| Role          | Description                                                                                                                                                                                                                                                                                                    |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Administrator | Has read and write access to all features and resources, as well as to the settings.                                                                                                                                                                                                                           |
| Accounting    | Has read and write access to the following areas:<br />\* Customers<br />\* Partners<br />\* Products<br />\* Price updates<br />\* Subscription feature assignment<br />\* Subscriptions<br />\* Shopping cart<br />\* All invoicing<br />\* All accounting areas<br />\* Dunning<br />\* Accounting settings |
| User          | Has read and write access to the following areas:<br />\* Customers<br />\* Partners<br />\* Products<br />\* Subscription feature assignment<br />\* Subscriptions<br />\* Shopping cart<br />\* Quotes<br />\* Invoices<br />\* Payments<br />\* Reports                                                     |

The roles can be individually customized for each user.

<Tabs>
  <Tab title="Using the Web App">
    <Steps>
      <Step title="Open the Settings">
        Go to [Settings > Users](https://app.fynn.eu/settings/users)
      </Step>

      <Step title="Click on the role selection field for the user">
        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/Oz1fjsoxDmWZX8Mb/images/settings-user-change-role.png?fit=max&auto=format&n=Oz1fjsoxDmWZX8Mb&q=85&s=aa27d587cb5d64aa688a096d3db19092" width="1152" height="398" data-path="images/settings-user-change-role.png" />
        </Frame>
      </Step>

      <Step title="Select the new role for the user" />

      <Step title="Role successfully changed">
        The role is now changed immediately and the user will have the corresponding permissions after the next navigation in the application.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Using the API">
    Use the [Update Role](/api-reference/account/update-account-role) endpoint for this.

    ```bash theme={null}
    PUT /accounts/{accountId}/role
    ```
  </Tab>
</Tabs>

<Info>
  You cannot change the permissions for your own account. If you want to change the permissions for your account, please contact another administrator of your organization.
</Info>

## Lock User

If a user should no longer have access to the organization, the user can be locked.

<Tabs>
  <Tab title="Using the Web App">
    <Steps>
      <Step title="Open the Settings">
        Go to [Settings > Users](https://app.fynn.eu/settings/users)
      </Step>

      <Step title="Click on the lock icon to lock the user">
        <Note>
          The user will be locked and will no longer be able to access the data.
          In the audit logs, the user will still be referenced to document the history of changes.
          The user will not receive a notification about being locked.
        </Note>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Using the API">
    Use the [Lock User](/api-reference/account/deactivate-account) endpoint for this.

    ```bash theme={null}
    PUT /accounts/{accountId}/deactivate
    ```
  </Tab>
</Tabs>

## Unlock User

If a user should have access to the organization again, the user can be unlocked.

<Tabs>
  <Tab title="Using the Web App">
    <Steps>
      <Step title="Open the Settings">
        Go to [Settings > Users](https://app.fynn.eu/settings/users)
      </Step>

      <Step title="Click on the lock icon to unlock the user">
        <Note>
          The user will be unlocked and will be able to access the data again.
          The user will not receive a notification about being unlocked.
        </Note>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Using the API">
    Use the [Unlock User](/api-reference/account/reactivate-account) endpoint for this.

    ```bash theme={null}
    PUT /accounts/{accountId}/reactivate
    ```
  </Tab>
</Tabs>

## Create Roles

Fynn offers the ability to create custom roles to define specific permissions for different user groups.

<Steps>
  <Step title="Open the Settings">
    Go to [Settings > Users](https://app.fynn.eu/settings/users)
  </Step>

  <Step title="Click on Add Role in the Roles section on the right side">
    <Frame>
      <img src="https://mintcdn.com/fynnsubscriptionbilling/1WHsrw9xV98b8NDj/images/fynn-eu-settings-add-new-role.png?fit=max&auto=format&n=1WHsrw9xV98b8NDj&q=85&s=44412dc3251f700f2571c7b6e3edb0c7" width="1678" height="1167" data-path="images/fynn-eu-settings-add-new-role.png" />
    </Frame>

    Choose a name for the role, check all permissions for this role, and click "Add Role".
  </Step>

  <Step title="Use the Role">
    The new role can now be assigned to an existing or new user.
  </Step>
</Steps>

## Edit Roles

<Note>
  Roles cannot currently be edited. If you want to edit a role, please contact support.
</Note>