addCompanyLocation

curl --request POST \
  --url 'https://sandbox.rollfi.xyz/companyOnboarding#addCompanyLocation' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "method": "addCompanyLocation",
  "companyLocation": {
    "companyId": "33A04AFB-4317-464A-B1E0-BAB610086174",
    "companyLocation": "Main",
    "address1": "8745 Colard Ln",
    "address2": "",
    "city": "Lyons",
    "state": "CO",
    "zipcode": "80540",
    "phoneNumber": "9889890989",
    "isWorkLocation": true,
    "isMailingAddress": true,
    "isFilingAddress": true
  }
}
'

{
  "companyLocation": {
    "companyLocationId": "EAE2367A-F86E-4495-B403-627FCCFD8184",
    "status": "Verification pending",
    "message": "Company Location has been saved successfully."
  }
}

Company Onboarding

addCompanyLocation

The addCompanyLocation API is used to add a company location. This step sets up the company’s primary physical location and is essential for regional compliance, tax jurisdiction, and audit readiness.

What it does:

Establishes the company’s physical presence and operational address
Enables proper tax jurisdiction for payroll processing and ensures regional compliance

Location Options:

Location	Description
WorkLocation	Physical addresses where the company has employees working in the United States
MailingAddress	Address where company correspondence and official mail is sent
FilingAddress	Address used for tax filings and regulatory submissions with government agencies

Notes:

This step must be completed before beginning the KYB verification process and is required for accurate payroll processing across different jurisdictions.
Companies must maintain at least one filing address at all times

POST

companyOnboarding#addCompanyLocation

addCompanyLocation

curl --request POST \
  --url 'https://sandbox.rollfi.xyz/companyOnboarding#addCompanyLocation' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "method": "addCompanyLocation",
  "companyLocation": {
    "companyId": "33A04AFB-4317-464A-B1E0-BAB610086174",
    "companyLocation": "Main",
    "address1": "8745 Colard Ln",
    "address2": "",
    "city": "Lyons",
    "state": "CO",
    "zipcode": "80540",
    "phoneNumber": "9889890989",
    "isWorkLocation": true,
    "isMailingAddress": true,
    "isFilingAddress": true
  }
}
'

{
  "companyLocation": {
    "companyLocationId": "EAE2367A-F86E-4495-B403-627FCCFD8184",
    "status": "Verification pending",
    "message": "Company Location has been saved successfully."
  }
}

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:

"addCompanyLocation"

companyLocation

object

required

Show child attributes

Response

companyLocation

object

required

Show child attributes

updateAdminUser addKybInformation

Documentation Index

Authorizations

Body

Response