URL Expired

The URL for this request expired after 30 days.

This endpoint patches company information and returns the updated Company Object

Only the company object parameters outlined in this API reference are able to be patched via this endpoint

Returns Skip link to Returns

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

int32

The ownership percentage held by the primary business owner.

legal_structure

string

enum

The legal structure of the business.

Show 13 enum values

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 theMM/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

string

enum

The default payroll schedule that the company follows

Allowed:

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

`200 200

`400 400

Updated 7 months ago

Shell

xxxxxxxxxx

{
  "companyID": "1e2wu23273238c22ea2",
  "first_name": "Richard",
  "last_name": "Hendricks",
  "email": "richard@piedpiper.com",
  "business_name": "Pied Piper",
  "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",
  "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"
}

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200 - Result400 - Result

Updated7 months ago