Companies

Create company

Creates a client company and links ownership context according to partner rules. Typical entrypoint for multi-tenant onboarding.

post/companies

Request

  • Base URL: https://api.100hires.com/v2
  • URL: https://api.100hires.com/v2/companies
  • Auth: HTTP bearer

Request body

namestring required

Company name.

websitestring

Company website URL.

urlstring

Company profile URL.

company_owner_emailstring email required

Company owner email address.

company_owner_namestring required

Company owner full name.

company_owner_phonestring

Company owner phone number.

is_staffing_agencyboolean

Whether this company is a staffing agency.

linkedin_company_idstring

Numeric LinkedIn Company ID, digits only, usually 6 to 9 digits. The company's jobs are posted to LinkedIn only when it is set: LinkedIn attaches every job in the feed to the page with this ID. Find it in the address bar after clicking See all jobs on the company page (the f_C value), in the page Admin View URL (the number after /company/), or in the public page source after urn:li:organization:. A vanity URL such as /company/acme-corp is not the ID.

linkedin_company_urlstring

LinkedIn company page URL, https://www.linkedin.com/company/<slug>. Set it together with linkedin_company_id.

job_board_namesobject

Company name per job board, keyed by the board name from GET /boards. linkedin and googlejobs are not accepted: LinkedIn shows the page set by linkedin_company_id, Google for Jobs reads the career site. A board that is not in the object keeps its stored name; null or an empty string removes the name, so the board shows the company name again. Indeed and ZipRecruiter pick up a change on the next job board sync, the other boards on the next feed build.

Response

Created company

idinteger required

Unique identifier

namestring required

Company name

websitestring nullable

Company website URL

urlstring nullable

Company careers page URL

is_staffing_agencyboolean

Whether this company is a staffing agency

logostring nullable

URL of the company logo image

company_owner_emailstring nullable

Email of the company owner

company_owner_phonestring nullable

Phone number of the company owner

company_owner_namestring nullable

Full name of the company owner

linkedin_company_idstring nullable

Numeric LinkedIn Company ID of the company page. The company's jobs are posted to LinkedIn only when it is set.

linkedin_company_urlstring nullable

LinkedIn company page URL, e.g. https://www.linkedin.com/company/acme-corp

job_board_namesobject

Company name shown on each job board, keyed by the board name from GET /boards. A board without an entry shows the company name. An empty object when no name is set.

Changes

No recorded changes to this operation across all 1 revision of this API.