Admin Portal
addBusinessContractor
API Reference
- Company Onboarding
- User Onboarding
- Admin Portal
- POSTaddCompanyBankAccount
- PUTdeactivateCompanyBankAccount
- POSTaddUser
- POSTaddBusinessContractor
- PUTupdateUser
- POSTaddUsers
- POSTaddStateRegistration
- PUTupdateStateRegistration
- POSTaddUserWage
- PUTupdateUserWage
- PUTupdateBusinessUserAsEmployee
- PUTupdateEmployeeAsBusinessUser
- PUTupdateBusinessUser
- PUTupdateCompanyLocation
- POSTactivateUser
- POSTdeactivateUser
- PUTterminateUser
- StateRegistration
- POST
- User Portal
- Payroll
- Benefits
- Reports
- Webhooks
Admin Portal
addBusinessContractor
This endpoint can be used to Create an BusinessContractor by providing the required fields
POST
/
adminPortal#addBusinessContractor
curl --request POST \
--url 'https://sandbox.rollfi.xyz/adminPortal#addBusinessContractor' \
--header 'Content-Type: application/json' \
--data '{
"method": "addBusinessContractor",
"user": {
"companyId": "A141A4B1-C742-4C43-9A45-E8CCC2FD87F7",
"legalName": "Pear Inc",
"userReferenceId": "",
"firstName": "Meery",
"middleName": "Austin",
"lastName": "Steve",
"email": "pear001@sto.com",
"phoneNumber": "9889890989",
"dateOfJoin": "2000-01-01",
"jobTitle": "Manager",
"companyLocationCategory": "Remote",
"code": "FL"
},
"userWage": {
"differentialPay": "No",
"wageRate": 1110,
"workerType": "W2",
"wageBasis": "Per Week",
"userType": "Salary/Eligible for overtime",
"employmentStatus": "Full Time (30+ Hours per week)",
"userRefTaxExempt": "Yes, as an owner/corporate officer",
"startDate": "2023-02-25",
"paymentMethod": "Check"
},
"kybInformation": {
"ein": "785698565",
"dateOfIncorporation": "2023-02-25"
},
"companyLocation": {
"address1": "8745 Colard Ln",
"address2": "",
"city": "Lyons",
"state": "CO",
"zipcode": "80540",
"country": "US",
"phoneNumber": "9889890989"
},
"businessUser": {
"address1": "8745 Colard Ln",
"address2": "",
"city": "Lyons",
"state": "CO",
"zipcode": "80540",
"country": "US",
"dateOfBirth": "2000-09-09",
"ownershipPercentage": 28
}
}'
{
"1": {
"summary": "Success",
"value": {
"businessContractor": {
"companyId": "B06FF5C9-D654-4B6F-ABF0-072AF5A7D1CF",
"kybInformationId": "51A02CD2-745A-4C77-B7C6-6711ABBD9EEE",
"userId": "088B3C3C-F7C2-4F42-999A-CC1FA135CE82",
"userWageId": "C62AD35C-5BDF-4B9F-9E0A-6C97A44730BF",
"businessUserId": "088B3C3C-F7C2-4F42-999A-CC1FA135CE82",
"companyLocationId": "401AB38E-5C90-48F1-BBEA-F7449B41DB80",
"status": "Registered",
"message": "A business contractor has been registered successfully and KYB verification is in progress."
}
}
}
}
Body
application/json
Maximum length:
40
Maximum length:
40
Maximum length:
35
Maximum length:
10
Available options:
W2
, 1099-NEC
Maximum length:
20
Available options:
Office
, Remote
Maximum length:
20
Maximum length:
40
Available options:
TX
, AK
, ND
, IL
, MA
, KS
, AS
, AL
, UT
, SD
, MI
, DC
, GA
, SC
, TN
, OK
, CO
, CA
, ME
, MO
, WY
, MD
, VT
, NM
, CT
, AZ
, WI
, VA
, WV
, NJ
, DE
, NC
, PR
, IN
, MT
, NH
, HI
, IA
, KY
, WA
, OH
, FL
, OR
, MP
, GU
, MN
, MS
, PA
, NE
, RI
, ID
, LA
, NY
, NV
, AR
Response
200
application/json
curl --request POST \
--url 'https://sandbox.rollfi.xyz/adminPortal#addBusinessContractor' \
--header 'Content-Type: application/json' \
--data '{
"method": "addBusinessContractor",
"user": {
"companyId": "A141A4B1-C742-4C43-9A45-E8CCC2FD87F7",
"legalName": "Pear Inc",
"userReferenceId": "",
"firstName": "Meery",
"middleName": "Austin",
"lastName": "Steve",
"email": "pear001@sto.com",
"phoneNumber": "9889890989",
"dateOfJoin": "2000-01-01",
"jobTitle": "Manager",
"companyLocationCategory": "Remote",
"code": "FL"
},
"userWage": {
"differentialPay": "No",
"wageRate": 1110,
"workerType": "W2",
"wageBasis": "Per Week",
"userType": "Salary/Eligible for overtime",
"employmentStatus": "Full Time (30+ Hours per week)",
"userRefTaxExempt": "Yes, as an owner/corporate officer",
"startDate": "2023-02-25",
"paymentMethod": "Check"
},
"kybInformation": {
"ein": "785698565",
"dateOfIncorporation": "2023-02-25"
},
"companyLocation": {
"address1": "8745 Colard Ln",
"address2": "",
"city": "Lyons",
"state": "CO",
"zipcode": "80540",
"country": "US",
"phoneNumber": "9889890989"
},
"businessUser": {
"address1": "8745 Colard Ln",
"address2": "",
"city": "Lyons",
"state": "CO",
"zipcode": "80540",
"country": "US",
"dateOfBirth": "2000-09-09",
"ownershipPercentage": 28
}
}'
{
"1": {
"summary": "Success",
"value": {
"businessContractor": {
"companyId": "B06FF5C9-D654-4B6F-ABF0-072AF5A7D1CF",
"kybInformationId": "51A02CD2-745A-4C77-B7C6-6711ABBD9EEE",
"userId": "088B3C3C-F7C2-4F42-999A-CC1FA135CE82",
"userWageId": "C62AD35C-5BDF-4B9F-9E0A-6C97A44730BF",
"businessUserId": "088B3C3C-F7C2-4F42-999A-CC1FA135CE82",
"companyLocationId": "401AB38E-5C90-48F1-BBEA-F7449B41DB80",
"status": "Registered",
"message": "A business contractor has been registered successfully and KYB verification is in progress."
}
}
}
}