addBusinessUser

curl --request POST \
  --url 'https://sandbox.rollfi.xyz/companyOnboarding#addBusinessUser' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "method": "addBusinessUser",
  "businessUser": {
    "companyId": "8A9B7683-8E02-494D-8422-963FD05EE785",
    "firstName": "Tim",
    "middleName": "",
    "lastName": "David",
    "phoneNumber": "9889890989",
    "email": "tim@david.xyz",
    "address1": "8745 Colard Ln",
    "address2": "",
    "city": "Lyons",
    "state": "CO",
    "zipcode": "80540",
    "ssn": "123098989",
    "dateOfBirth": "2000-09-09",
    "payrollAdmin": true,
    "bookKeeper": true,
    "beneficialOwner": true,
    "ownershipPercentage": 25
  }
}
'

{
  "businessUser": {
    "businessUserId": "5370FF7F-9FFF-401A-A949-AFB393B50F09",
    "status": "KYC Pending",
    "message": "Tim David has been successfully added as BusinessUser."
  }
}

Company Onboarding

addBusinessUser

The addBusinessUser API is used to create a Business User and define their permissions and responsibilities within the system.

What it does:

Creates a Business User with defined roles and permissions
Establishes user access levels based on assigned roles providing role-based functionality
Supports multiple role assignments for flexible user management

Business User Roles:

A Business User can have one or more of these roles:

Role	Description
Payroll Admin	Full access to payroll processing and management functions
Beneficial Owner	Legal ownership stake in the company (At least 25% share must be stated)
Book Keeper	Usually limited access to read-only for company accounting purposes and reporting

Notes:

At least one beneficial owner with at least 25% share of the company must be registered to the system for compliance. A sole beneficial owner cannot be deleted before another is added.
For beneficial owners dateOfBirth, address1, address2, city, state, zipcode, ssn and ownershipPercentage are mandatory for compliance purposes.

POST

companyOnboarding#addBusinessUser

addBusinessUser

curl --request POST \
  --url 'https://sandbox.rollfi.xyz/companyOnboarding#addBusinessUser' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "method": "addBusinessUser",
  "businessUser": {
    "companyId": "8A9B7683-8E02-494D-8422-963FD05EE785",
    "firstName": "Tim",
    "middleName": "",
    "lastName": "David",
    "phoneNumber": "9889890989",
    "email": "tim@david.xyz",
    "address1": "8745 Colard Ln",
    "address2": "",
    "city": "Lyons",
    "state": "CO",
    "zipcode": "80540",
    "ssn": "123098989",
    "dateOfBirth": "2000-09-09",
    "payrollAdmin": true,
    "bookKeeper": true,
    "beneficialOwner": true,
    "ownershipPercentage": 25
  }
}
'

{
  "businessUser": {
    "businessUserId": "5370FF7F-9FFF-401A-A949-AFB393B50F09",
    "status": "KYC Pending",
    "message": "Tim David has been successfully added as BusinessUser."
  }
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

method

string

required

Example:

"addBusinessUser"

businessUser

object

required

Show child attributes

Response

businessUser

object

required

Show child attributes

initiateCompanyKyb addBookKeeper

Documentation Index

Authorizations

Body

Response