Create Company

The first entity for payroll calculation you must create is Company. You must send a POST request to the Create Company endpoint to create a company. You can find more about the endpoint in the API Reference.

However, to call the create company endpoint, you must be a System level user. A successfully created company is automatically added to current System level user permissions.


User Types

See more about a system-level user here.

In creating a company, you need to set the required fields. These fields must not be empty to ensure the successful creation of your company.

Company Information

The system requires that you set some essential company information like:

Company Name

The company name is a string parameter that should be the company's legal name. If the company is doing business under a different name, you can also use the tradeName property.

The company name property is of the alphanumeric type and has a maximum character count of 100.

Federal Employer Identification Number (FEIN)

Federal Employer Identification Number (or EIN) is a nine-digit number the IRS assigns in the following format: XX-XXXXXXX. The number helps identify the tax accounts of employers and others with no employees.

Our API requires pure nine digits without any separators or whitespace. We do not validate your EIN against IRS records. Hence, you have the responsibility of using your IRS-issued EIN.

Company Type

This is the parameter that defines the legal form of your company. This should be a number between 1 and 10. Each digit represents a specific type. The company type may be based on Liability, Members, or Control. As a result, your company may belong to any of the following categories:

Integer representationBusiness TypeAbbreviation
3.LLCSCorpLLC S-Corp.
4.LLCLLC C-Corp.
5.LLCSoleProprietorLLC Sole Proprietor.
6.SoleProprietorshipSole Proprietor.
7.LLCPartnershipLLC Partnership.
9.NonProfitNon Profit.
10.GovernmentalEntityGovernmental Entity.

NOTE: You input this parameter as an integer.

Company Address

The companyAddress is an object that contains information about the company’s business address. This address is one of the sources for the tax parameters, so you can’t use a fake or nonexistent address here. The system processes the address and must find proper tax information about it. An adequately set company address must contain the following:

  • Business Address Lines which are of the alphanumeric type.
  • City, which is of the alphanumeric type.
  • State or State short form, which is text only.
  • Correct Zip code, which is of the numeric type only.

Bank Account Number and Routing Number

The bank account number and routing numbers are for identifying bank and bank accounts in the US. They are an essential aspect of your company information that you need to set. Since our API requires these numbers for validation purposes, you must input the correct numbers.

Your Bank Account Number should have a maximum of 20 characters to avoid validation errors, while the Routing Number is usually a 9-digit numeric character.

Payroll Policy

Configuring your Payroll policy is another section of your company's information that you need to set. You determine the following information when setting this section:

Pay Frequency

You set your Pay frequency based on your company policy. It could be Weekly, Bi-weekly, Semi-monthly, and Monthly.


Second Pay Period End Date

Configuring your pay frequency to this option includes the option of the Second Pay period end date. This second pay period end date usually has a default value of 15 days after the First pay period end date.

However, the date usually takes value from a day after the First Pay Period End date to 31 calendar days after the First Pay Period end date.

First Pay Period End Date

You set this date according to the Pay frequency. This date is the date when your employee's first pay period ends. The default value is usually set at the current company creation date. However, this parameter can only take value from the first day of the current year's first month to the previous month's last day of the following year.

First Pay Date

This date is your company's predetermined date or day of employee payment. It is usually the day your payroll makes its first payment for the previous pay period. By default, this date is set as five calendar days after the First Pay Period End date, but it usually takes its value from 10 days before your First Pay Period End date to 31 days after the First Pay Period End date.

Move Pay Day on Holidays and Weekends

If your Pay date falls on a weekend or holiday, you can preset when your company decides to pay its employees. You can always pay the last business day before or the first business day after the weekend or holidays.

You must ensure the required information is spelled correctly and carefully before moving ahead with other entities to ensure a successful create company endpoint call.