For the complete documentation index, see llms.txt. This page is also available as Markdown.

Webhooks: Company API

Overview

The topic introduces the main information for Company API webhook subscriptions.

There are two types of webhook subscriptions available:

Feature
Company profile changes

Update frequency

Daily

Webhook triggers

170+ data fields

Best for

Monitoring general profile updates


Subscription method

You can subscribe to updates in two ways. Use the Subscription method column to find the correct endpoint for your needs.

Subscription method
Company profile changes subscription endpoint

By ID List

/v2/subscriptions/company_multi_source/ids

By Elasticsearch DSL

/v2/subscriptions/company_multi_source/es_dsl

Webhook payload

See what information is included in webhook notifications.

Company webhooks

Each webhook notification includes the following fields:

  • company_id – The ID of the company profile that was updated.

  • status – The type of change detected (see status values below).

  • changed_fields – An array listing the specific fields that were modified on the profile.

Example payload
[
  {
    "company_id": 125,
    "status": "changed",
    "changed_fields": ["description", "industry"]
  }
]

The changed_fields array tells you exactly which parts of the profile were modified. You can use this to decide whether to retrieve the full updated profile or skip the notification based on your use case.

Webhook triggers

Identify the company data fields that trigger company profile change notifications.

Fields that trigger webhooks
Field
Change type

acquired_by_summary

new, updated, deleted

acquisition_list_source_1

new, deleted

acquisition_list_source_1.acquiree_name

new, updated

acquisition_list_source_1.announced_date

new, updated, deleted

acquisition_list_source_1.currency

new, deleted

acquisition_list_source_1.price

new, updated, deleted

acquisition_list_source_2

new, deleted

acquisition_list_source_2.price

updated

acquisition_list_source_5

new, deleted

acquisition_list_source_5.currency

new

acquisition_list_source_5.price

new

active_job_postings

new, deleted

active_job_postings.job_posting_title

updated

average_visit_duration_seconds

new, updated, deleted

avg_tenure_by_department_months

new, updated, deleted

avg_tenure_by_seniority_months

new, updated, deleted

bounce_rate

new, updated, deleted

canonical_professional_network_url

updated

categories_and_keywords

updated

company_emails

updated

company_employee_reviews_aggregate_score

new, updated, deleted

company_employee_reviews_count

new, updated, deleted

company_legal_name

new, updated, deleted

company_locations_full

new, deleted

company_locations_full.city

new, updated, deleted

company_locations_full.country

new, updated, deleted

company_locations_full.country_iso_2

new, updated, deleted

company_locations_full.country_iso_3

new, updated, deleted

company_locations_full.is_primary

updated, deleted

company_locations_full.latitude

new, updated, deleted

company_locations_full.location_address

new, updated, deleted

company_locations_full.longitude

new, updated, deleted

company_locations_full.regions

new, updated, deleted

company_locations_full.state

new, updated, deleted

company_locations_full.street

new

company_locations_full.zip_code

new

company_logo

new, updated, deleted

company_logo_url

new, updated, deleted

company_name

updated

company_name_alias

updated

company_phone_numbers

updated

competitors

new, deleted

competitors.company_name

new, updated, deleted

competitors_websites

new, deleted

financial_website_url

new, updated, deleted

demo_available

new, updated

departures_count

new, updated, deleted

description

new, updated, deleted

description_enriched

new, updated, deleted

description_metadata_raw

new, updated, deleted

discord_url

updated

documentation_exist

new, updated

employee_reviews_score_breakdown

new, updated, deleted

employee_reviews_score_distribution

new, updated, deleted

employees_count

updated

employees_count_breakdown_by_department

new, updated, deleted

employees_count_breakdown_by_region

new, updated, deleted

employees_count_breakdown_by_seniority

new, updated, deleted

employees_count_inferred

new, updated, deleted

facebook_url

updated

followers_count_professional_network

updated

followers_count_owler

new, updated, deleted

founded_year

new, updated, deleted

free_trial_available

new, updated

funding_rounds

new, deleted

funding_rounds.amount_raised

new, updated, deleted

funding_rounds.amount_raised_currency

new, updated, deleted

funding_rounds.announced_date

new, updated, deleted

funding_rounds.investors

new, updated, deleted

funding_rounds.num_investors

new, updated, deleted

funding_rounds.num_partners

new, updated, deleted

funding_rounds.type

new, updated, deleted

github_url

updated

hq_apartment

new, updated, deleted

hq_city

new, updated, deleted

hq_country

new, updated, deleted

hq_country_iso2

new, updated, deleted

hq_country_iso3

new, updated, deleted

hq_full_address

new, updated, deleted

hq_latitude

new, updated, deleted

hq_location

new, updated, deleted

hq_longitude

new, updated, deleted

hq_region

updated

hq_state

new, updated, deleted

hq_street

new, updated, deleted

hq_suite

new, updated, deleted

hq_zipcode

new, updated, deleted

income_statements

new, deleted

income_statements.cost_of_goods_sold

new, updated, deleted

income_statements.cost_of_goods_sold_currency

new, updated

income_statements.earnings_per_share

new, updated, deleted

income_statements.ebit

new, updated, deleted

income_statements.ebit_margin

new, updated, deleted

income_statements.ebitda

new, updated, deleted

income_statements.ebitda_margin

new, updated, deleted

income_statements.gross_profit

new, updated, deleted

income_statements.gross_profit_margin

new, updated, deleted

income_statements.income_tax_expense

new, updated, deleted

income_statements.interest_expense

new, updated, deleted

income_statements.interest_income

new, updated, deleted

income_statements.net_income

new, updated, deleted

income_statements.period_display_end_date

new, updated

income_statements.period_end_date

new, updated

income_statements.period_type

new, updated

income_statements.pre_tax_profit

new, updated, deleted

income_statements.revenue

new, updated, deleted

income_statements.total_operating_expense

new, updated, deleted

industry

new, updated, deleted

instagram_url

updated

ipo_date

new, updated, deleted

ipo_share_price

new, deleted

ipo_share_price_currency

new, deleted

is_downloadable

new, updated

is_public

updated

key_employee_change_events

new, deleted

key_employee_change_events.employee_change_event_date

updated, deleted

key_employee_change_events.employee_change_event_name

updated, deleted

key_employee_change_events.employee_change_event_url

updated, deleted

key_executive_arrivals

new, deleted

key_executive_arrivals.member_full_name

updated

key_executive_arrivals.member_position_title

updated

key_executive_departures

new, deleted

key_executive_departures.departure_date

new, updated, deleted

key_executive_departures.member_full_name

new, updated, deleted

key_executive_departures.member_position_title

new, updated, deleted

key_executive_departures.parent_id

new, updated, deleted

key_executives

new, deleted

key_executives.member_full_name

new, updated, deleted

key_executives.member_position_title

new, updated, deleted

key_executives.parent_id

new, updated, deleted

last_funding_round

new, updated, deleted

professional_network_url

updated

mobile_apps_exist

new, updated

naics_codes

updated

online_reviews_exist

new, updated

ownership_status

new, updated, deleted

pages_per_visit

new, updated, deleted

parent_company_information

new, updated, deleted

pinterest_url

updated

pricing_available

new, updated

product_pricing_summary

new, deleted

product_pricing_summary.price

updated

product_reviews_aggregate_score

new, updated, deleted

product_reviews_count

new, updated, deleted

product_reviews_score_distribution

new, updated, deleted

reddit_url

updated

revenue_annual

new, updated, deleted

revenue_annual_range

new, updated, deleted

revenue_quarterly

new, updated, deleted

sic_codes

updated

similarly_ranked_websites

updated

size_range

new, updated, deleted

status

new, updated, deleted

stock_information

new, deleted

stock_information.closing_price

updated

stock_information.currency

updated

stock_information.marketcap

updated

stock_ticker

new, deleted

technologies_used

new, deleted

technologies_used.last_verified_at

updated

tiktok_url

updated

top_next_companies

new, deleted

top_next_companies.company_name

updated

top_next_companies.count

updated

top_previous_companies

new, deleted

top_previous_companies.company_name

updated

top_previous_companies.count

updated

top_topics

updated

total_website_visits_monthly

new, updated, deleted

twitter_url

updated

type

new, updated, deleted

visits_breakdown_by_country

new, deleted

visits_breakdown_by_country.country

deleted

visits_breakdown_by_country.percentage

updated, deleted

visits_breakdown_by_country.percentage_monthly_change

new, updated, deleted

website

new, updated, deleted

website_alias

updated

website_domain

new, updated, deleted

youtube_url

updated

Trackable fields

The following fields can be used with the tracked_fields parameter (subscribe by field) and will appear in the changed_fields array in webhook payloads. This list is used to track changes via Company Webhook subscriptions.

Tracked fields list
Field
Field
Field

acquired_by_summary

acquisition_list_source_1

acquisition_list_source_1.acquiree_name

acquisition_list_source_1.announced_date

acquisition_list_source_1.currency

acquisition_list_source_1.price

acquisition_list_source_2

acquisition_list_source_2.price

acquisition_list_source_5

acquisition_list_source_5.currency

acquisition_list_source_5.price

active_job_postings

active_job_postings.job_posting_title

average_visit_duration_seconds

avg_tenure_by_department_months

avg_tenure_by_seniority_months

bounce_rate

canonical_professional_network_url

categories_and_keywords

company_emails

company_employee_reviews_aggregate_score

company_employee_reviews_count

company_legal_name

company_locations_full

company_locations_full.city

company_locations_full.country

company_locations_full.country_iso_2

company_locations_full.country_iso_3

company_locations_full.is_primary

company_locations_full.latitude

company_locations_full.location_address

company_locations_full.longitude

company_locations_full.regions

company_locations_full.state

company_locations_full.street

company_locations_full.zip_code

company_logo

company_logo_url

company_name

company_name_alias

company_phone_numbers

competitors

competitors.company_name

competitors_websites

financial_website_url

demo_available

departures_count

description

description_enriched

description_metadata_raw

discord_url

documentation_exist

employee_reviews_score_breakdown

employee_reviews_score_distribution

employees_count

employees_count_breakdown_by_department

employees_count_breakdown_by_region

employees_count_breakdown_by_seniority

employees_count_inferred

facebook_url

followers_count_professional_network

followers_count_owler

founded_year

free_trial_available

funding_rounds

funding_rounds.amount_raised

funding_rounds.amount_raised_currency

funding_rounds.announced_date

funding_rounds.investors

funding_rounds.num_investors

funding_rounds.num_partners

funding_rounds.type

github_url

hq_apartment

hq_city

hq_country

hq_country_iso2

hq_country_iso3

hq_full_address

hq_latitude

hq_location

hq_longitude

hq_region

hq_state

hq_street

hq_suite

hq_zipcode

income_statements

income_statements.cost_of_goods_sold

income_statements.cost_of_goods_sold_currency

income_statements.earnings_per_share

income_statements.ebit

income_statements.ebit_margin

income_statements.ebitda

income_statements.ebitda_margin

income_statements.gross_profit

income_statements.gross_profit_margin

income_statements.income_tax_expense

income_statements.interest_expense

income_statements.interest_income

income_statements.net_income

income_statements.period_display_end_date

income_statements.period_end_date

income_statements.period_type

income_statements.pre_tax_profit

income_statements.revenue

income_statements.total_operating_expense

industry

instagram_url

ipo_date

ipo_share_price

ipo_share_price_currency

is_downloadable

is_public

key_employee_change_events

key_employee_change_events.employee_change_event_date

key_employee_change_events.employee_change_event_name

key_employee_change_events.employee_change_event_url

key_executive_arrivals

key_executive_arrivals.member_full_name

key_executive_arrivals.member_position_title

key_executive_departures

key_executive_departures.departure_date

key_executive_departures.member_full_name

key_executive_departures.member_position_title

key_executive_departures.parent_id

key_executives

key_executives.member_full_name

key_executives.member_position_title

key_executives.parent_id

last_funding_round

professional_network_url

mobile_apps_exist

naics_codes

online_reviews_exist

ownership_status

pages_per_visit

parent_company_information

pinterest_url

pricing_available

product_pricing_summary

product_pricing_summary.price

product_reviews_aggregate_score

product_reviews_count

product_reviews_score_distribution

reddit_url

revenue_annual

revenue_annual_range

revenue_quarterly

sic_codes

similarly_ranked_websites

size_range

status

stock_information

stock_information.closing_price

stock_information.currency

stock_information.marketcap

stock_ticker

technologies_used

technologies_used.last_verified_at

tiktok_url

top_next_companies

top_next_companies.company_name

top_next_companies.count

top_previous_companies

top_previous_companies.company_name

top_previous_companies.count

top_topics

total_website_visits_monthly

twitter_url

type

visits_breakdown_by_country

visits_breakdown_by_country.country

visits_breakdown_by_country.percentage

visits_breakdown_by_country.percentage_monthly_change

website

website_alias

website_domain

youtube_url

Company webhooks

Subscribe using IDs

Get notifications if one of webhook triggers has been updated:

Subscribe by fields and track company_name and key_employee_change_events changes:

Subscribe using Elasticsearch DSL

Get notifications if one of webhook triggers has been updated:

Subscribe by fields and track company_name and competitors changes:

Retrieving updated profile data

After receiving a webhook notification, use the changed_fields array to determine if you need to fetch the updated profile data.

Single profile update

To see the exact changes in one profile, you will have to use the company ID (company_id) in the following endpoint:

Multiple profile updates

To identify the changes in multiple profiles, you need to export the company IDs and use them with the following Bulk Collect endpoints:

Follow the instructions here to successfully collect the company data:

Last updated

Was this helpful?