Sign in

v1

latestOpenAPI 3.1.02026-07-2414339465.7 KB

Create Company

Creates a company within Zeal.

post/companies

Request body

partnerIDstring required

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

first_namestring required

First name of business owner or administrator.

last_namestring required

Last name of business owner or administrator.

emailstring required

Email address of business.

business_namestring required

Legal name of business.

business_einstring required

Federal EIN of business.

business_addressstring required

Street address component of business address

business_citystring required

City component of business address

business_statestring required

State component of business address

business_zipstring required

Zip code component of business address

business_phonestring required

Phone number of business

mail_addressstring required

Mailing address of company

mail_citystring required

Mailing city of company

mail_statestring required

Mailing state of company

mail_zipstring required

Mailing ZIP code of company

skip_migrationboolean

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.

ssnstring required

SSN of the primary business owner.

ownership_percentageinteger required

The ownership percentage held by the primary business owner.

legal_structure'ccorp' | 'corp' | 'estate' | 'foreign_entity' | 'llc' | 'llp' | 'lp' | 'nonprofit' | 'partnership' | 'scheme' | 'scorp' | 'soleprop' | 'trust' required

The legal structure of the business.

job_titlestring

The job title of the primary business owner.

company_type'all' | 'contractor_only'

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

dobstring required

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

addressstring required

Address of the primary business owner.

address_line2string

Address line 2 of the primary business owner.

citystring required

City of the primary business owner.

statestring required

State of the primary business owner.

zipstring required

Zip code of the primary business owner.

payroll_schedule'daily' | 'weekly' | 'biweekly' | 'semimonthly' | 'monthly'

The default payroll schedule that the company follows

payroll_firstDatestring

The ISO-8601 date of the first regular payroll

payroll_firstPayPeriodIDstring

Reporting period ID of the first regular payroll

Response

200

successboolean

Example response

{
  "success": true,
  "data": {
    "companyID": "1ea89873acdae98734",
    "status": "initial_onboarding",
    "first_name": "richard",
    "last_name": "hendricks",
    "email": "richard@piedpiper.com",
    "business_name": "Pied Piper",
    "business_ein": "073647583",
    "business_address": "1 Market St.",
    "business_city": "San Francisco",
    "business_state": "CA",
    "business_zip": "94110",
    "business_phone": "2025550151",
    "mail_address": "1 Market St.",
    "mail_city": "San Francisco",
    "mail_state": "CA",
    "mail_zip": "94110",
    "is_sandbox": true,
    "ssn": "22-333-4444",
    "ownership_percentage": 25,
    "dob": "01/01/1990",
    "legal_structure": "ccorp",
    "job_title": "CEO",
    "address": "1 Ferry Building",
    "city": "San francisco",
    "state": "CA",
    "zip": "94105",
    "company_type": "all",
    "onboarding_url": "/employeronboard/1ea89873acdae98734?companyID=1ea89873acdae98734&classification=TEST",
    "payroll_firstCheckDate": "2024-08-30",
    "payroll_schedule": "weekly",
    "payroll_firstPayPeriodID": "6580ce4a3808d60023b4e412"
  }
}