---
updatedAt: 2025-08-14T13:39:05.000Z
agentTools:
  siteIndex: https://developer.n-able.com/llms.txt
  projectIndex: https://developer.n-able.com/n-able-cove/llms.txt
---

# Adding users

To add users, use the AddUser method. Users are added one at a time.

## Required parameters

| Parameter | Description                               | Supported values                                                                                                       |
| --------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| userInfo  | A group of parameters related to the user | UserInfo (has child parameters of its own see the [UserInfo child parameters](#userinfo-child-parameters) table below) |

### UserInfo child parameters

<Table>
  <thead>
    <tr>
      <th>
        Parameter
      </th>

      <th>
        Description
      </th>

      <th>
        Supported values
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        ID
      </td>

      <td>
        The ID number of the user
      </td>

      <td>
        &lt;int&gt; Integer
      </td>
    </tr>

    <tr>
      <td>
        PartnerId
      </td>

      <td>
        The ID of the customer the user is created for (retrieved through the GetPartnerInfo method)
      </td>

      <td>
        &lt;int&gt; Integer
      </td>
    </tr>

    <tr>
      <td>
        Name (required)
      </td>

      <td>
        A login name for the user (must be the same as the EmailAddress)
      </td>

      <td>
        OptionalNonEmptyString
      </td>
    </tr>

    <tr>
      <td>
        Password
      </td>

      <td>
        Set a password for the new user
      </td>

      <td>
        OptionalNonEmptyString
      </td>
    </tr>

    <tr>
      <td>
        RoleId
      </td>

      <td>
        The ID of the role the user will be given (retrieved through the enumerateUserRoles method)
      </td>

      <td>
        &lt;int&gt; Integer  

        Choose Int that correlates to the role below:  

        * 1 - SuperUser
        * 2 - Administrator
        * 3 - Manager
        * 4 - Operator
        * 5 - Supporter
        * 6 - Reporter
        * 7 - Notifier
      </td>
    </tr>

    <tr>
      <td>
        ContactPersonId
      </td>

      <td>
        The ID of the contact person that this new user will be associated with
      </td>

      <td>
        &lt;int&gt; Integer
      </td>
    </tr>

    <tr>
      <td>
        TwoFactorAuthenticationStatus
      </td>

      <td>
        An array of 2FA state's to give to the new user
      </td>

      <td>
        TwoFactorAuthenticationState::Enum  

        * Undefined
        * Disabled
        * Enabled
        * Count
      </td>
    </tr>

    <tr>
      <td>
        EmailAddress
      </td>

      <td>
        The email address of the user (must be the same as the Name given)
      </td>

      <td>
        &lt;std::String&gt;
      </td>
    </tr>

    <tr>
      <td>
        Flags
      </td>

      <td>
        Flag the user with certain feature access
      </td>

      <td>
        UserFlag::FlagsType  

        * Undefined
        * TeamViewer
        * AuthorizedSigner
        * Administrative
        * Technical
        * Sales
        * Billing
        * Count
      </td>
    </tr>

    <tr>
      <td>
        FirstLoginTime
      </td>

      <td>
        The time-stamp of the first time the user has logged in successfully
      </td>

      <td>
        +&lt;std::time_t&gt; Integer in Unix format. For example, 1535673599 stands for August 30, 2018
      </td>
    </tr>

    <tr>
      <td>
        LastLoginTime
      </td>

      <td>
        The time-stamp of the last time the user has logged in successfully
      </td>

      <td>
        &lt;std::time_t&gt; Integer in Unix format. For example, 1535673599 stands for August 30, 2018
      </td>
    </tr>

    <tr>
      <td>
        FirstName
      </td>

      <td>
        The first name of the user
      </td>

      <td>
        &lt;std::String&gt;
      </td>
    </tr>

    <tr>
      <td>
        FullName
      </td>

      <td>
        The surname of the user
      </td>

      <td>
        &lt;std::String&gt;
      </td>
    </tr>

    <tr>
      <td>
        Title
      </td>

      <td>
        A title given to the user of the user
      </td>

      <td>
        &lt;std::String&gt;
      </td>
    </tr>

    <tr>
      <td>
        PhoneNumber
      </td>

      <td>
        The phone number of the user
      </td>

      <td>
        &lt;std::String&gt;
      </td>
    </tr>
  </tbody>
</Table>

## Sample request

```json
{
    "id": "jsonrpc",
    "jsonrpc": "2.0",
    "visa": "{{visa}}",
    "method": "AddUser",
    "params": {
	    "userInfo": {
		"Name" : "backup.test@mail.com",
		"PartnerId" : 123456,
		"Password" : "AbC123DeF!",
		"RoleId" : 1,
		"EmailAddress" : "backup.test@mail.com",
		"FirstName" : "Backup",
		"FullName" : "Test",
		"Title": "Manager"
	    }
    }
}
```

## Sample response

```json
{
    "id": "jsonrpc",
    "jsonrpc": "2.0",
    "result": {
	"result": 876543
    },
    "visa": "{{visa}}"
}
```