Skip to main content
POST
Create Company
This endpoint registers a new employer company under your Zeal partner account and returns a companyID you will use in every subsequent API call for that company. See The Company Object for the full field reference.

Authorizations

Authorization
string
header
required

Body

application/json
partnerID
string
required

Your Partner ID (found in the API page of your Admin portal)

first_name
string
required

First name of business owner or administrator.

last_name
string
required

Last name of business owner or administrator.

email
string
required

Email address of business.

business_name
string
required

Legal name of business.

business_ein
string
required

Federal EIN of business.

business_address
string
required

Street address component of business address

business_city
string
required

City component of business address

business_state
string
required

State component of business address

business_zip
string
required

Zip code component of business address

business_phone
string
required

Phone number of business

mail_address
string
required

Mailing address of company

mail_city
string
required

Mailing city of company

mail_state
string
required

Mailing state of company

mail_zip
string
required

Mailing ZIP code of company

ssn
string
required

SSN of the primary business owner.

ownership_percentage
integer<int32>
required

The ownership percentage held by the primary business owner.

legal_structure
enum<string>
required

The legal structure of the business.

Available options:
ccorp,
corp,
estate,
foreign_entity,
llc,
llp,
lp,
nonprofit,
partnership,
scheme,
scorp,
soleprop,
trust
dob
string
required

Date of birth of the primary business owner. This should be in theMM/DD/YYYY format

address
string
required

Address of the primary business owner.

city
string
required

City of the primary business owner.

state
string
required

State of the primary business owner.

zip
string
required

Zip code of the primary business owner.

skip_migration
boolean
default:false

If true, Zeal will skip migrating payroll information from the company's old payroll provider. Note: please confirm with the company that migration is not necessary. Failure to migrate old records may impact tax reporting and filing.

job_title
string

The job title of the primary business owner.

company_type
enum<string>

Mark your company as "all" (employees and contractors) or "contractor_only" to limit company's scope to 1099 contractors.

Available options:
all,
contractor_only
address_line2
string

Address line 2 of the primary business owner.

payroll_schedule
enum<string>

The default payroll schedule that the company follows

Available options:
daily,
weekly,
biweekly,
semimonthly,
monthly
payroll_firstDate
string

The ISO-8601 date of the first regular payroll

payroll_firstPayPeriodID
string

Reporting period ID of the first regular payroll

product_type
enum<string>

The Zeal product type for the company. Defaults to your partner's configured product type, or payroll. Returns a 400 if your partner account isn't enabled for the requested product type.

Available options:
payroll,
onboarding_only
physical_address
string

Street address component of the company's physical address. Only needed if it differs from the business address.

physical_city
string

City component of the company's physical address

physical_state
string

State component of the company's physical address

physical_zip
string

Zip code component of the company's physical address

Response

200

success
boolean
default:true
Example:

true

data
object