Company.New
Triggered when a new company matching your saved search criteria is discovered. [Learn more about webhooks](https://theirstack.com/en/docs/webhooks).
Request Body
application/json
- idintegerrequired
Unique identifier for this webhook event
- typestringrequired
Event type indicating what triggered the webhook: 'job.new' for new jobs or 'company.new' for new companies
- job.new
- company.new
- payloadJobWithMatchingPhrases | CompanyWithTechnologiesAndJobsrequired
Event data containing the job or company information that triggered the webhook. If the type is 'job.new', the payload will be a JobWithMatchingPhrases object. If the type is 'company.new', the payload will be a CompanyWithTechnologiesAndJobs object.
- idintegerrequired
ID of the job
- job_titlestringrequired
Job title
- urlstringnullable
URL of the job post
- date_postedstringdaterequired
Date when the job was posted
- has_blurred_databooleandefault: false
Whether the returned object has company identifiable data blurred or not
- companystringdeprecatedrequired
Company name. This field is deprecated, please don't use it
- final_urlstringnullable
Is the URL of the job in the career page of the company.
- source_urlstringnullable
Is the url TheirStack used to get the job data.
- locationstringnullabledeprecated
This is the city of the job.
- short_locationstringnullabledeprecated
It's a combination of the city and the state of the job.
- long_locationstringnullabledeprecated
It's a combination of the city, the state and the postal code of the job.
- state_codestringnullabledeprecated
The state code of the job.
- latitudenumbernullabledeprecated
The latitude of the job.
- longitudenumbernullabledeprecated
The longitude of the job.
- postal_codestringnullabledeprecated
The postal code of the job.
- remotebooleannullable
If the job is remote.
- hybridbooleannullable
If the job is hybrid. A hybrid position is a job that combines remote and in-office work.
- salary_stringstringnullable
The salary of the job in the local currency. If a similar field is present in the job source, this property will contain the same content. If no similar field is present, the content will be have the following format: <min_annual_salary> - <max_annual_salary> per year. For the currencies where the symbol precedes the digits, the format will be <min_annual_salary> - <max_annual_salary> per year. In these latter two cases, both the min and max annual salary are expressed in either k (for thousands) or M (for millions).
- min_annual_salaryintegernullable
The minimum annual salary of the job in the local currency.
- min_annual_salary_usdnumbernullable
The minimum annual salary of the job in USD.
- max_annual_salaryintegernullable
The maximum annual salary of the job in the local currency.
- max_annual_salary_usdnumbernullable
The maximum annual salary of the job in USD.
- avg_annual_salary_usdnumbernullable
This property calculates the average annual salary for a job in USD, based on the available minimum and maximum annual salary values (both already converted to USD): If both min_annual_salary_usd and max_annual_salary_usd are missing or zero, it returns None. If only the minimum is missing, it returns the maximum value. If only the maximum is missing, it returns the minimum value. If both are present, it returns the average of the two, rounded to two decimal places. This ensures the property always provides the best possible estimate of the average salary, even if only one bound is available.
- salary_currencystringnullable
The currency of the salary of the job.
- countriesarray<string>nullabledeprecated
Countries of the job
- countrystringnullabledeprecated
Country name of the job
- country_codesarray<string | null>nullabledeprecated
Two-letter country codes (ISO 3166-1 alpha-2) representing the job's locations.
- country_codestringnullabledeprecated
Two-letter country code (ISO 3166-1 alpha-2) representing the job's location. If the job has multiple locations, the first one is returned.
- citiesarray<string>nullabledeprecated
Cities of the job
- continentsarray<string>nullabledeprecated
Continents of the job
- senioritystringnullable
Seniority level of the job
- c_level
- staff
- senior
- junior
- mid_level
- discovered_atstringdate-timerequired
Date when the job was discovered by TheirStack
- company_domainstringnullable
Company website domain
- hiring_teamarray<PersonBase>nullable
Hiring team who posted the job
- repostedbooleannullable
Indicates whether the employer has republished this job posting.
- date_repostedstringnullabledate
Date when the job was reposted
- employment_statusesarray<Commitment>default: []
Employment statuses of the job
- full_time
- part_time
- temporary
- internship
- contract
- easy_applybooleannullable
Indicates whether the job application can be submitted directly through the job board (easy_apply=True) or requires redirecting to the company's website (easy_apply=False).
- keyword_slugsarray<string>default: []
Slugs of the technologies of the job
- descriptionstringnullable
Job description in markdown format
- company_objectobjectrequired
Company object
- locationsarray<JobLocation>default: []
All possible locations of the job with coordinates, city, state, state_code, country_code, etc.
- normalized_titlestringnullable
- manager_rolesarray<string>nullable
Roles of the person or people found in the job description to be the managers of the hired person. Can be useful to infer who's the decision maker for the technologies mentioned in the job post.
- matching_phrasesarray<string | null>nullabledefault: []
Phrases from the job description that match the pattern passed
- matching_wordsarray<string | null>nullabledefault: []
Words from the job description that match the pattern passed
Response Body
application/json
application/json
Example Requests
/company-newHow is this guide?
Last updated on
Receive TheirStack events in your webhook endpoint
Learn the essential technical requirements for building webhook endpoints that receive TheirStack job and company data. Covers status codes, retry logic, concurrency handling, and duplicate prevention.
Job.New Webhook
Triggered when a new job matching your saved search criteria is discovered. [Learn more about webhooks](https://theirstack.com/en/docs/webhooks).