updateBusinessUser
curl --request PUT \
--url https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
"{\r\n \"method\": \"updateBusinessUser\",\r\n \"businessUser\": {\r\n \"businessUserId\": \"67DEFFE5-ADC9-4B21-A3B4-194C468290F4\",\r\n \"firstName\": \"Marcus\",\r\n \"middleName\": \"\",\r\n \"lastName\": \"Steve\",\r\n \"email\": \"marcus020@sto.com\",\r\n \"phoneNumber\": \"9988884377\",\r\n \"address1\": \"8745 Colard Ln\",\r\n \"address2\": \"\",\r\n \"city\": \"Lyons\",\r\n \"state\": \"CO\",\r\n \"zipcode\": \"80540\",\r\n \"country\": \"US\",\r\n \"ssn\": \"745896325\",\r\n \"dateOfBirth\": \"2000-09-09\",\r\n \"payrollAdmin\": true,\r\n \"bookkeeper\": true,\r\n \"beneficialOwner\": true,\r\n \"ownershipPercentage\": 25,\r\n }\r\n}"
'import requests
url = "https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser"
payload = "{
\"method\": \"updateBusinessUser\",
\"businessUser\": {
\"businessUserId\": \"67DEFFE5-ADC9-4B21-A3B4-194C468290F4\",
\"firstName\": \"Marcus\",
\"middleName\": \"\",
\"lastName\": \"Steve\",
\"email\": \"marcus020@sto.com\",
\"phoneNumber\": \"9988884377\",
\"address1\": \"8745 Colard Ln\",
\"address2\": \"\",
\"city\": \"Lyons\",
\"state\": \"CO\",
\"zipcode\": \"80540\",
\"country\": \"US\",
\"ssn\": \"745896325\",
\"dateOfBirth\": \"2000-09-09\",
\"payrollAdmin\": true,
\"bookkeeper\": true,
\"beneficialOwner\": true,
\"ownershipPercentage\": 25,
}
}"
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify('{\r\n "method": "updateBusinessUser",\r\n "businessUser": {\r\n "businessUserId": "67DEFFE5-ADC9-4B21-A3B4-194C468290F4",\r\n "firstName": "Marcus",\r\n "middleName": "",\r\n "lastName": "Steve",\r\n "email": "marcus020@sto.com",\r\n "phoneNumber": "9988884377",\r\n "address1": "8745 Colard Ln",\r\n "address2": "",\r\n "city": "Lyons",\r\n "state": "CO",\r\n "zipcode": "80540",\r\n "country": "US",\r\n "ssn": "745896325",\r\n "dateOfBirth": "2000-09-09",\r\n "payrollAdmin": true,\r\n "bookkeeper": true,\r\n "beneficialOwner": true,\r\n "ownershipPercentage": 25,\r\n }\r\n}')
};
fetch('https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode('{
"method": "updateBusinessUser",
"businessUser": {
"businessUserId": "67DEFFE5-ADC9-4B21-A3B4-194C468290F4",
"firstName": "Marcus",
"middleName": "",
"lastName": "Steve",
"email": "marcus020@sto.com",
"phoneNumber": "9988884377",
"address1": "8745 Colard Ln",
"address2": "",
"city": "Lyons",
"state": "CO",
"zipcode": "80540",
"country": "US",
"ssn": "745896325",
"dateOfBirth": "2000-09-09",
"payrollAdmin": true,
"bookkeeper": true,
"beneficialOwner": true,
"ownershipPercentage": 25,
}
}'),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser"
payload := strings.NewReader("\"{\\r\\n \\\"method\\\": \\\"updateBusinessUser\\\",\\r\\n \\\"businessUser\\\": {\\r\\n \\\"businessUserId\\\": \\\"67DEFFE5-ADC9-4B21-A3B4-194C468290F4\\\",\\r\\n \\\"firstName\\\": \\\"Marcus\\\",\\r\\n \\\"middleName\\\": \\\"\\\",\\r\\n \\\"lastName\\\": \\\"Steve\\\",\\r\\n \\\"email\\\": \\\"marcus020@sto.com\\\",\\r\\n \\\"phoneNumber\\\": \\\"9988884377\\\",\\r\\n \\\"address1\\\": \\\"8745 Colard Ln\\\",\\r\\n \\\"address2\\\": \\\"\\\",\\r\\n \\\"city\\\": \\\"Lyons\\\",\\r\\n \\\"state\\\": \\\"CO\\\",\\r\\n \\\"zipcode\\\": \\\"80540\\\",\\r\\n \\\"country\\\": \\\"US\\\",\\r\\n \\\"ssn\\\": \\\"745896325\\\",\\r\\n \\\"dateOfBirth\\\": \\\"2000-09-09\\\",\\r\\n \\\"payrollAdmin\\\": true,\\r\\n \\\"bookkeeper\\\": true,\\r\\n \\\"beneficialOwner\\\": true,\\r\\n \\\"ownershipPercentage\\\": 25,\\r\\n }\\r\\n}\"")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("\"{\\r\\n \\\"method\\\": \\\"updateBusinessUser\\\",\\r\\n \\\"businessUser\\\": {\\r\\n \\\"businessUserId\\\": \\\"67DEFFE5-ADC9-4B21-A3B4-194C468290F4\\\",\\r\\n \\\"firstName\\\": \\\"Marcus\\\",\\r\\n \\\"middleName\\\": \\\"\\\",\\r\\n \\\"lastName\\\": \\\"Steve\\\",\\r\\n \\\"email\\\": \\\"marcus020@sto.com\\\",\\r\\n \\\"phoneNumber\\\": \\\"9988884377\\\",\\r\\n \\\"address1\\\": \\\"8745 Colard Ln\\\",\\r\\n \\\"address2\\\": \\\"\\\",\\r\\n \\\"city\\\": \\\"Lyons\\\",\\r\\n \\\"state\\\": \\\"CO\\\",\\r\\n \\\"zipcode\\\": \\\"80540\\\",\\r\\n \\\"country\\\": \\\"US\\\",\\r\\n \\\"ssn\\\": \\\"745896325\\\",\\r\\n \\\"dateOfBirth\\\": \\\"2000-09-09\\\",\\r\\n \\\"payrollAdmin\\\": true,\\r\\n \\\"bookkeeper\\\": true,\\r\\n \\\"beneficialOwner\\\": true,\\r\\n \\\"ownershipPercentage\\\": 25,\\r\\n }\\r\\n}\"")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "\"{\\r\\n \\\"method\\\": \\\"updateBusinessUser\\\",\\r\\n \\\"businessUser\\\": {\\r\\n \\\"businessUserId\\\": \\\"67DEFFE5-ADC9-4B21-A3B4-194C468290F4\\\",\\r\\n \\\"firstName\\\": \\\"Marcus\\\",\\r\\n \\\"middleName\\\": \\\"\\\",\\r\\n \\\"lastName\\\": \\\"Steve\\\",\\r\\n \\\"email\\\": \\\"marcus020@sto.com\\\",\\r\\n \\\"phoneNumber\\\": \\\"9988884377\\\",\\r\\n \\\"address1\\\": \\\"8745 Colard Ln\\\",\\r\\n \\\"address2\\\": \\\"\\\",\\r\\n \\\"city\\\": \\\"Lyons\\\",\\r\\n \\\"state\\\": \\\"CO\\\",\\r\\n \\\"zipcode\\\": \\\"80540\\\",\\r\\n \\\"country\\\": \\\"US\\\",\\r\\n \\\"ssn\\\": \\\"745896325\\\",\\r\\n \\\"dateOfBirth\\\": \\\"2000-09-09\\\",\\r\\n \\\"payrollAdmin\\\": true,\\r\\n \\\"bookkeeper\\\": true,\\r\\n \\\"beneficialOwner\\\": true,\\r\\n \\\"ownershipPercentage\\\": 25,\\r\\n }\\r\\n}\""
response = http.request(request)
puts response.read_body{
"businessUser": {
"businessUserId": "3819B535-F3AA-4E5E-A055-16D33CE68315",
"status": "Ready",
"message": "The Business User has been updated successfully."
}
}{
"error": {
"code": 400,
"message": "First Name should not exceed 40 characters."
}
}Admin Portal
updateBusinessUser
The updateBusinessUser API updates Business User details in the system.
What it does:
- Supports multiple roles: Payroll Admin, Controller, Beneficial Owner, Employee
- Preserves existing user data while updating only specified fields
Notes:
- Run
getBusinessUserDetailsendpoint first to get current information before updating - Requires ownership percentage specification for Beneficial Owner role
PUT
/
adminPortal
/
updateBusinessUser
updateBusinessUser
curl --request PUT \
--url https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
"{\r\n \"method\": \"updateBusinessUser\",\r\n \"businessUser\": {\r\n \"businessUserId\": \"67DEFFE5-ADC9-4B21-A3B4-194C468290F4\",\r\n \"firstName\": \"Marcus\",\r\n \"middleName\": \"\",\r\n \"lastName\": \"Steve\",\r\n \"email\": \"marcus020@sto.com\",\r\n \"phoneNumber\": \"9988884377\",\r\n \"address1\": \"8745 Colard Ln\",\r\n \"address2\": \"\",\r\n \"city\": \"Lyons\",\r\n \"state\": \"CO\",\r\n \"zipcode\": \"80540\",\r\n \"country\": \"US\",\r\n \"ssn\": \"745896325\",\r\n \"dateOfBirth\": \"2000-09-09\",\r\n \"payrollAdmin\": true,\r\n \"bookkeeper\": true,\r\n \"beneficialOwner\": true,\r\n \"ownershipPercentage\": 25,\r\n }\r\n}"
'import requests
url = "https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser"
payload = "{
\"method\": \"updateBusinessUser\",
\"businessUser\": {
\"businessUserId\": \"67DEFFE5-ADC9-4B21-A3B4-194C468290F4\",
\"firstName\": \"Marcus\",
\"middleName\": \"\",
\"lastName\": \"Steve\",
\"email\": \"marcus020@sto.com\",
\"phoneNumber\": \"9988884377\",
\"address1\": \"8745 Colard Ln\",
\"address2\": \"\",
\"city\": \"Lyons\",
\"state\": \"CO\",
\"zipcode\": \"80540\",
\"country\": \"US\",
\"ssn\": \"745896325\",
\"dateOfBirth\": \"2000-09-09\",
\"payrollAdmin\": true,
\"bookkeeper\": true,
\"beneficialOwner\": true,
\"ownershipPercentage\": 25,
}
}"
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify('{\r\n "method": "updateBusinessUser",\r\n "businessUser": {\r\n "businessUserId": "67DEFFE5-ADC9-4B21-A3B4-194C468290F4",\r\n "firstName": "Marcus",\r\n "middleName": "",\r\n "lastName": "Steve",\r\n "email": "marcus020@sto.com",\r\n "phoneNumber": "9988884377",\r\n "address1": "8745 Colard Ln",\r\n "address2": "",\r\n "city": "Lyons",\r\n "state": "CO",\r\n "zipcode": "80540",\r\n "country": "US",\r\n "ssn": "745896325",\r\n "dateOfBirth": "2000-09-09",\r\n "payrollAdmin": true,\r\n "bookkeeper": true,\r\n "beneficialOwner": true,\r\n "ownershipPercentage": 25,\r\n }\r\n}')
};
fetch('https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode('{
"method": "updateBusinessUser",
"businessUser": {
"businessUserId": "67DEFFE5-ADC9-4B21-A3B4-194C468290F4",
"firstName": "Marcus",
"middleName": "",
"lastName": "Steve",
"email": "marcus020@sto.com",
"phoneNumber": "9988884377",
"address1": "8745 Colard Ln",
"address2": "",
"city": "Lyons",
"state": "CO",
"zipcode": "80540",
"country": "US",
"ssn": "745896325",
"dateOfBirth": "2000-09-09",
"payrollAdmin": true,
"bookkeeper": true,
"beneficialOwner": true,
"ownershipPercentage": 25,
}
}'),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser"
payload := strings.NewReader("\"{\\r\\n \\\"method\\\": \\\"updateBusinessUser\\\",\\r\\n \\\"businessUser\\\": {\\r\\n \\\"businessUserId\\\": \\\"67DEFFE5-ADC9-4B21-A3B4-194C468290F4\\\",\\r\\n \\\"firstName\\\": \\\"Marcus\\\",\\r\\n \\\"middleName\\\": \\\"\\\",\\r\\n \\\"lastName\\\": \\\"Steve\\\",\\r\\n \\\"email\\\": \\\"marcus020@sto.com\\\",\\r\\n \\\"phoneNumber\\\": \\\"9988884377\\\",\\r\\n \\\"address1\\\": \\\"8745 Colard Ln\\\",\\r\\n \\\"address2\\\": \\\"\\\",\\r\\n \\\"city\\\": \\\"Lyons\\\",\\r\\n \\\"state\\\": \\\"CO\\\",\\r\\n \\\"zipcode\\\": \\\"80540\\\",\\r\\n \\\"country\\\": \\\"US\\\",\\r\\n \\\"ssn\\\": \\\"745896325\\\",\\r\\n \\\"dateOfBirth\\\": \\\"2000-09-09\\\",\\r\\n \\\"payrollAdmin\\\": true,\\r\\n \\\"bookkeeper\\\": true,\\r\\n \\\"beneficialOwner\\\": true,\\r\\n \\\"ownershipPercentage\\\": 25,\\r\\n }\\r\\n}\"")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("\"{\\r\\n \\\"method\\\": \\\"updateBusinessUser\\\",\\r\\n \\\"businessUser\\\": {\\r\\n \\\"businessUserId\\\": \\\"67DEFFE5-ADC9-4B21-A3B4-194C468290F4\\\",\\r\\n \\\"firstName\\\": \\\"Marcus\\\",\\r\\n \\\"middleName\\\": \\\"\\\",\\r\\n \\\"lastName\\\": \\\"Steve\\\",\\r\\n \\\"email\\\": \\\"marcus020@sto.com\\\",\\r\\n \\\"phoneNumber\\\": \\\"9988884377\\\",\\r\\n \\\"address1\\\": \\\"8745 Colard Ln\\\",\\r\\n \\\"address2\\\": \\\"\\\",\\r\\n \\\"city\\\": \\\"Lyons\\\",\\r\\n \\\"state\\\": \\\"CO\\\",\\r\\n \\\"zipcode\\\": \\\"80540\\\",\\r\\n \\\"country\\\": \\\"US\\\",\\r\\n \\\"ssn\\\": \\\"745896325\\\",\\r\\n \\\"dateOfBirth\\\": \\\"2000-09-09\\\",\\r\\n \\\"payrollAdmin\\\": true,\\r\\n \\\"bookkeeper\\\": true,\\r\\n \\\"beneficialOwner\\\": true,\\r\\n \\\"ownershipPercentage\\\": 25,\\r\\n }\\r\\n}\"")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.rollfi.xyz/adminPortal/updateBusinessUser")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "\"{\\r\\n \\\"method\\\": \\\"updateBusinessUser\\\",\\r\\n \\\"businessUser\\\": {\\r\\n \\\"businessUserId\\\": \\\"67DEFFE5-ADC9-4B21-A3B4-194C468290F4\\\",\\r\\n \\\"firstName\\\": \\\"Marcus\\\",\\r\\n \\\"middleName\\\": \\\"\\\",\\r\\n \\\"lastName\\\": \\\"Steve\\\",\\r\\n \\\"email\\\": \\\"marcus020@sto.com\\\",\\r\\n \\\"phoneNumber\\\": \\\"9988884377\\\",\\r\\n \\\"address1\\\": \\\"8745 Colard Ln\\\",\\r\\n \\\"address2\\\": \\\"\\\",\\r\\n \\\"city\\\": \\\"Lyons\\\",\\r\\n \\\"state\\\": \\\"CO\\\",\\r\\n \\\"zipcode\\\": \\\"80540\\\",\\r\\n \\\"country\\\": \\\"US\\\",\\r\\n \\\"ssn\\\": \\\"745896325\\\",\\r\\n \\\"dateOfBirth\\\": \\\"2000-09-09\\\",\\r\\n \\\"payrollAdmin\\\": true,\\r\\n \\\"bookkeeper\\\": true,\\r\\n \\\"beneficialOwner\\\": true,\\r\\n \\\"ownershipPercentage\\\": 25,\\r\\n }\\r\\n}\""
response = http.request(request)
puts response.read_body{
"businessUser": {
"businessUserId": "3819B535-F3AA-4E5E-A055-16D33CE68315",
"status": "Ready",
"message": "The Business User has been updated successfully."
}
}{
"error": {
"code": 400,
"message": "First Name should not exceed 40 characters."
}
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
Response
Show child attributes
Show child attributes
⌘I
