---
title: "Update Company Information"
method: PATCH
path: "/companies"
---

# Update Company Information

`PATCH /companies`

Update the Company Object

## Request body

- object
  - `companyID` string, required — Company ID of the employer (you can access companyID on the Zeal dashboard)
  - `first_name` string — First name of business owner or administrator.
  - `last_name` string — Last name of business owner or administrator.
  - `email` string — Email address of business.
  - `business_name` string — Business Name of company
  - `business_phone` string — Phone number of company
  - `business_address` string — Street address of company's business address
  - `business_city` string — City of company's business address
  - `business_state` string — State of company's business address
  - `business_zip` string — Zip code of company's business address
  - `mail_address` string — Mailing address of company
  - `mail_city` string — Mailing city of company
  - `mail_state` string — Mailing state of company
  - `mail_zip` string — Mailing zip code of company
  - `ssn` string — SSN of the primary business owner.
  - `ownership_percentage` integer — 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' — The legal structure of the business.
  - `job_title` string — The job title of the primary business owner.
  - `dob` string — Date of birth of the primary business owner. This should be in the`MM/DD/YYYY` format.
  - `address` string — Address of the primary business owner.
  - `address_line2` string — Address line 2 of the primary business owner.
  - `city` string — City of the primary business owner.
  - `state` string — State of the primary business owner.
  - `zip` string — 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
    - `first_name` string
    - `last_name` string
    - `email` string
    - `business_name` string
    - `business_address` string
    - `business_city` string
    - `business_state` string
    - `business_zip` string
    - `business_phone` string
    - `mail_address` string
    - `mail_city` string
    - `mail_state` string
    - `mail_zip` string
    - `ssn` string
    - `ownership_percentage` integer
    - `dob` string
    - `legal_structure` string
    - `job_title` string
    - `address` string
    - `city` string
    - `state` string
    - `zip` 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)