---
title: "Create Company"
method: POST
path: "/companies"
---

# Create Company

`POST /companies`

Creates a company within Zeal.

## Request body

- object
  - `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
  - `skip_migration` boolean — 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.**
  - `ssn` string, required — SSN of the primary business owner.
  - `ownership_percentage` integer, 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_title` string — 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.
  - `dob` string, required — Date of birth of the primary business owner. This should be in the`MM/DD/YYYY` format
  - `address` string, required — Address of the primary business owner.
  - `address_line2` string — Address line 2 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.
  - `payroll_schedule` 'daily' | 'weekly' | 'biweekly' | 'semimonthly' | 'monthly' — The default payroll schedule that the company follows
  - `payroll_firstDate` string — The ISO-8601 date of the first regular payroll
  - `payroll_firstPayPeriodID` string — Reporting period ID of the first regular payroll

## Response `200`

200

- object
  - `success` boolean
  - `data` object
    - `companyID` string
    - `status` string
    - `first_name` string
    - `last_name` string
    - `email` string
    - `business_name` string
    - `business_ein` string
    - `business_address` string
    - `business_city` string
    - `business_state` string
    - `business_zip` string
    - `skip_migration` boolean
    - `business_phone` string
    - `mail_address` string
    - `mail_city` string
    - `mail_state` string
    - `mail_zip` string
    - `requirements` unknown[]
      - unknown
    - `account_number` unknown
    - `routing_number` unknown
    - `is_sandbox` boolean
    - `ssn` string
    - `ownership_percentage` integer
    - `dob` string
    - `legal_structure` string
    - `job_title` string
    - `address` string
    - `city` string
    - `state` string
    - `zip` string
    - `company_type` string
    - `onboarding_url` string
    - `payroll_firstCheckDate` string
    - `payroll_schedule` string
    - `payroll_firstPayPeriodID` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/zeal/apis/zeal-api.md) · [All operations](https://skmtc.net/zeal/apis/zeal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zeal/zeal-api/versions/01346dceb27d/schema)