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

# Add a user

export const RoleCard = ({title, byRequestOnly = false, children}) => {
  return <div className="flex items-stretch rounded-2xl bg-white dark:bg-background-dark border border-gray-950/10 dark:border-white/10 overflow-hidden mb-2.5">

      <div className="w-44 min-w-[11rem] flex flex-col justify-center items-start gap-2 p-5 border-r border-gray-950/10 dark:border-white/10">
        <span className="text-base font-semibold">
          {title}
        </span>
        {byRequestOnly && <span className="text-sm font-medium px-2 py-0.5 rounded-full border border-blue-200 dark:border-blue-900 bg-blue-50 dark:bg-blue-600/20 text-blue-900 dark:text-blue-200 w-fit">
            By request only
          </span>}
      </div>

      <div className="flex-1 p-5 prose dark:prose-invert max-w-none">
        {children}
      </div>

    </div>;
};

export const Available = ({to}) => <>
    <strong>Available to <Tooltip tip="Roles determine what each user can see and do in the merchant dashboard." cta="See role descriptions" href="/merchant-administration/add-a-user#determine-which-role-to-use">roles</Tooltip></strong>:
    {to.map(role => <>{" "}<Badge color="blue">{role}</Badge></>)}
</>;

<Available to={["Owner"]} />

Add users to your merchant account and assign roles that match their responsibilities. This page explains how to choose the right role, invite a new user, and request **Owner** access when needed.

## Determine which role to use

User roles define what each user can see and do in the merchant dashboard.

<Note>Roles marked **By request only** cannot be assigned directly from the dashboard. Contact your account manager to assign them.</Note>

<RoleCard title="View">
  For users who need read access to account activity, with a limited set of transactional actions.

  <Expandable title="permissions">
    * View account balance, account information, fees, cold addresses, transactions, payments, invoices, payment requests, mass payouts, withdrawal and operation limits, team members, and contacts
    * Manage deposit addresses
    * Resend transaction callbacks
    * Create payment requests and invoices
  </Expandable>
</RoleCard>

<RoleCard title="Exchange">
  For users who need to convert funds between currency balances.

  <Expandable title="permissions">
    * All **View** permissions
    * Exchange funds
  </Expandable>
</RoleCard>

<RoleCard title="Limits">
  For users who configure withdrawal thresholds and cold wallet transfer rules.

  <Expandable title="permissions">
    * All **View** permissions
    * Manage keep-on-hot limits
    * Manage the minimum transaction amount for automatic transfers to cold wallets
  </Expandable>
</RoleCard>

<RoleCard title="Submitter" byRequestOnly>
  For users who initiate crypto withdrawals and payouts but should not be able to approve them.

  <Expandable title="permissions">
    <Warning>For the **Submitter** role to function as intended, withdrawal limits must be configured. If no limits are configured, or if a withdrawal amount does not exceed the configured limit, withdrawals created by a **Submitter** will be processed immediately without requiring approval.</Warning>

    * All **View** permissions
    * Create crypto withdrawals
    * Create mass payouts
  </Expandable>
</RoleCard>

<RoleCard title="Approver" byRequestOnly>
  For users who approve withdrawals but should not be able to initiate them.

  <Expandable title="permissions">
    * All **View** permissions
    * Approve or decline withdrawals that require manual approval
  </Expandable>
</RoleCard>

<RoleCard title="Accountant">
  For users who manage fiat operations and bank accounts.

  <Expandable title="permissions">
    * All **View** permissions
    * Create fiat withdrawals
    * Create fiat top-ups
    * View and add bank accounts
  </Expandable>
</RoleCard>

<RoleCard title="Accounts Payable" byRequestOnly>
  For users who manage both crypto and fiat operations.

  <Expandable title="permissions">
    <Warning>For the **Accounts Payable** role to function as intended, withdrawal limits must be configured. If no limits are configured, or if a withdrawal amount does not exceed the configured limit, withdrawals created by an **Accounts Payable** user will be processed immediately without requiring approval.</Warning>

    * All **View** permissions
    * Create fiat withdrawals
    * Create fiat top-ups
    * View and add bank accounts
    * Create crypto withdrawals
    * Create mass payouts
    * Exchange funds
  </Expandable>
</RoleCard>

<RoleCard title="Owner" byRequestOnly>
  Full access to the merchant account and all dashboard sections.

  <Expandable title="permissions">
    * Includes permissions from all other roles
    * Add and remove users, and update user roles
    * Manage API keys
    * Configure callbacks, notifications, and withdrawal limits
    * Manage cold addresses
    * Manage active currencies (shown on the **Balances** tab)
    * Withdraw funds
    * Create fiat top-up orders
    * Configure withdrawal limits
    * Approve withdrawals that exceed the withdrawal limit
    * Create mass payouts
  </Expandable>
</RoleCard>

<RoleCard title="Restricted">
  No access to the merchant dashboard. Can contact the Support team and create tickets.
</RoleCard>

## Add a new user

Follow these steps to add a new user:

<Steps>
  <Step title="In your merchant dashboard, go to the Team tab and click Add users." />

  <Step title="Enter the user's email address.">
    The user will receive an invitation email at this address with instructions on how to activate their account.
  </Step>

  <Step title="Select a role for the user.">
    Refer to the section above for information about user roles.

    <Note>
      The **Owner**, **Submitter**, **Approver**, and **Accounts Payable** roles can only be assigned by contacting your account manager. To create a user with one of these roles, first create the user with the **View** role, then contact your account manager and provide the user's email address.
    </Note>
  </Step>

  <Step title="Enter your 2FA code and click Add.">
    The user will receive an email with their login and temporary password. For instructions on initial account setup, refer to [Log in and configure 2FA](/merchant-administration/log-in-and-configure-2-fa).
  </Step>
</Steps>

## FAQ

### How do I add a user with the Owner, Submitter, Approver, or Accounts Payable role?

First, create a new user with the **View** role. Then, contact your account manager to assign the role to this user. For the **Owner** role, you will be asked to complete a special authorization form before the role is granted.

### Why can't a Restricted user access the merchant dashboard?

Users with the **Restricted** role do not have access to the merchant dashboard and are logged out immediately after entering their credentials. Users with the **Restricted** role only have access to the help center.