> For the complete documentation index, see [llms.txt](https://docs.coresignal.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coresignal.com/company-data/api/webhooks.md).

# Webhooks: Company API

Subscribe to Company API profile updates via webhooks. Configure subscriptions by company ID or Elasticsearch DSL, track specific fields, and retrieve updated data.

## Overview

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

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Webhook subscriptions</strong></td><td>Try to simulate a subscription and explore subscription management options</td><td><a href="/api-introduction/webhooks.md">Webhooks</a></td></tr><tr><td><strong>Company webhooks</strong></td><td>General information on how Company Webhooks work</td><td><a href="/api-introduction/webhooks/company-webhooks.md">Company Webhooks</a></td></tr></tbody></table>

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.

<details>

<summary>Company webhooks</summary>

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.

{% code title="Example payload" %}

```json
[
  {
    "company_id": 125,
    "status": "changed",
    "changed_fields": ["description", "industry"]
  }
]
```

{% endcode %}

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.

</details>

## Webhook triggers

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

<details>

<summary>Fields that trigger webhooks</summary>

<table data-search="false"><thead><tr><th>Field</th><th>Change type</th></tr></thead><tbody><tr><td><code>acquired_by_summary</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>acquisition_list_source_1</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>acquisition_list_source_1.acquiree_name</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>acquisition_list_source_1.announced_date</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>acquisition_list_source_1.currency</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>acquisition_list_source_1.price</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>acquisition_list_source_2</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>acquisition_list_source_2.price</code></td><td><code>updated</code></td></tr><tr><td><code>acquisition_list_source_5</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>acquisition_list_source_5.currency</code></td><td><code>new</code></td></tr><tr><td><code>acquisition_list_source_5.price</code></td><td><code>new</code></td></tr><tr><td><code>active_job_postings</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>active_job_postings.job_posting_title</code></td><td><code>updated</code></td></tr><tr><td><code>average_visit_duration_seconds</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>avg_tenure_by_department_months</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>avg_tenure_by_seniority_months</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>bounce_rate</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>canonical_professional_network_url</code></td><td><code>updated</code></td></tr><tr><td><code>categories_and_keywords</code></td><td><code>updated</code></td></tr><tr><td><code>company_emails</code></td><td><code>updated</code></td></tr><tr><td><code>company_employee_reviews_aggregate_score</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_employee_reviews_count</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_legal_name</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full.city</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full.country</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full.country_iso_2</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full.country_iso_3</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full.is_primary</code></td><td><code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full.latitude</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full.location_address</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full.longitude</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full.regions</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full.state</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_locations_full.street</code></td><td><code>new</code></td></tr><tr><td><code>company_locations_full.zip_code</code></td><td><code>new</code></td></tr><tr><td><code>company_logo</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_logo_url</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>company_name</code></td><td><code>updated</code></td></tr><tr><td><code>company_name_alias</code></td><td><code>updated</code></td></tr><tr><td><code>company_phone_numbers</code></td><td><code>updated</code></td></tr><tr><td><code>competitors</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>competitors.company_name</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>competitors_websites</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>financial_website_url</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>demo_available</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>departures_count</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>description</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>description_enriched</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>description_metadata_raw</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>discord_url</code></td><td><code>updated</code></td></tr><tr><td><code>documentation_exist</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>employee_reviews_score_breakdown</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>employee_reviews_score_distribution</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>employees_count</code></td><td><code>updated</code></td></tr><tr><td><code>employees_count_breakdown_by_department</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>employees_count_breakdown_by_region</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>employees_count_breakdown_by_seniority</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>employees_count_inferred</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>facebook_url</code></td><td><code>updated</code></td></tr><tr><td><code>followers_count_professional_network</code></td><td><code>updated</code></td></tr><tr><td><code>followers_count_owler</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>founded_year</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>free_trial_available</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>funding_rounds</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>funding_rounds.amount_raised</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>funding_rounds.amount_raised_currency</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>funding_rounds.announced_date</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>funding_rounds.investors</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>funding_rounds.num_investors</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>funding_rounds.num_partners</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>funding_rounds.type</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>github_url</code></td><td><code>updated</code></td></tr><tr><td><code>hq_apartment</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_city</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_country</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_country_iso2</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_country_iso3</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_full_address</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_latitude</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_location</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_longitude</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_region</code></td><td><code>updated</code></td></tr><tr><td><code>hq_state</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_street</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_suite</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>hq_zipcode</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.cost_of_goods_sold</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.cost_of_goods_sold_currency</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>income_statements.earnings_per_share</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.ebit</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.ebit_margin</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.ebitda</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.ebitda_margin</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.gross_profit</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.gross_profit_margin</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.income_tax_expense</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.interest_expense</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.interest_income</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.net_income</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.period_display_end_date</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>income_statements.period_end_date</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>income_statements.period_type</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>income_statements.pre_tax_profit</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.revenue</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>income_statements.total_operating_expense</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>industry</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>instagram_url</code></td><td><code>updated</code></td></tr><tr><td><code>ipo_date</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>ipo_share_price</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>ipo_share_price_currency</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>is_downloadable</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>is_public</code></td><td><code>updated</code></td></tr><tr><td><code>key_employee_change_events</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>key_employee_change_events.employee_change_event_date</code></td><td><code>updated</code>, <code>deleted</code></td></tr><tr><td><code>key_employee_change_events.employee_change_event_name</code></td><td><code>updated</code>, <code>deleted</code></td></tr><tr><td><code>key_employee_change_events.employee_change_event_url</code></td><td><code>updated</code>, <code>deleted</code></td></tr><tr><td><code>key_executive_arrivals</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>key_executive_arrivals.member_full_name</code></td><td><code>updated</code></td></tr><tr><td><code>key_executive_arrivals.member_position_title</code></td><td><code>updated</code></td></tr><tr><td><code>key_executive_departures</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>key_executive_departures.departure_date</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>key_executive_departures.member_full_name</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>key_executive_departures.member_position_title</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>key_executive_departures.parent_id</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>key_executives</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>key_executives.member_full_name</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>key_executives.member_position_title</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>key_executives.parent_id</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>last_funding_round</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>professional_network_url</code></td><td><code>updated</code></td></tr><tr><td><code>mobile_apps_exist</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>naics_codes</code></td><td><code>updated</code></td></tr><tr><td><code>online_reviews_exist</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>ownership_status</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>pages_per_visit</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>parent_company_information</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>pinterest_url</code></td><td><code>updated</code></td></tr><tr><td><code>pricing_available</code></td><td><code>new</code>, <code>updated</code></td></tr><tr><td><code>product_pricing_summary</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>product_pricing_summary.price</code></td><td><code>updated</code></td></tr><tr><td><code>product_reviews_aggregate_score</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>product_reviews_count</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>product_reviews_score_distribution</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>reddit_url</code></td><td><code>updated</code></td></tr><tr><td><code>revenue_annual</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>revenue_annual_range</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>revenue_quarterly</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>sic_codes</code></td><td><code>updated</code></td></tr><tr><td><code>similarly_ranked_websites</code></td><td><code>updated</code></td></tr><tr><td><code>size_range</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>status</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>stock_information</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>stock_information.closing_price</code></td><td><code>updated</code></td></tr><tr><td><code>stock_information.currency</code></td><td><code>updated</code></td></tr><tr><td><code>stock_information.marketcap</code></td><td><code>updated</code></td></tr><tr><td><code>stock_ticker</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>technologies_used</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>technologies_used.last_verified_at</code></td><td><code>updated</code></td></tr><tr><td><code>tiktok_url</code></td><td><code>updated</code></td></tr><tr><td><code>top_next_companies</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>top_next_companies.company_name</code></td><td><code>updated</code></td></tr><tr><td><code>top_next_companies.count</code></td><td><code>updated</code></td></tr><tr><td><code>top_previous_companies</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>top_previous_companies.company_name</code></td><td><code>updated</code></td></tr><tr><td><code>top_previous_companies.count</code></td><td><code>updated</code></td></tr><tr><td><code>top_topics</code></td><td><code>updated</code></td></tr><tr><td><code>total_website_visits_monthly</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>twitter_url</code></td><td><code>updated</code></td></tr><tr><td><code>type</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>visits_breakdown_by_country</code></td><td><code>new</code>, <code>deleted</code></td></tr><tr><td><code>visits_breakdown_by_country.country</code></td><td><code>deleted</code></td></tr><tr><td><code>visits_breakdown_by_country.percentage</code></td><td><code>updated</code>, <code>deleted</code></td></tr><tr><td><code>visits_breakdown_by_country.percentage_monthly_change</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>website</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>website_alias</code></td><td><code>updated</code></td></tr><tr><td><code>website_domain</code></td><td><code>new</code>, <code>updated</code>, <code>deleted</code></td></tr><tr><td><code>youtube_url</code></td><td><code>updated</code></td></tr></tbody></table>

</details>

## 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.

<details>

<summary>Tracked fields list</summary>

<table data-search="false"><thead><tr><th>Field</th><th>Field</th><th>Field</th></tr></thead><tbody><tr><td><code>acquired_by_summary</code></td><td><code>acquisition_list_source_1</code></td><td><code>acquisition_list_source_1.acquiree_name</code></td></tr><tr><td><code>acquisition_list_source_1.announced_date</code></td><td><code>acquisition_list_source_1.currency</code></td><td><code>acquisition_list_source_1.price</code></td></tr><tr><td><code>acquisition_list_source_2</code></td><td><code>acquisition_list_source_2.price</code></td><td><code>acquisition_list_source_5</code></td></tr><tr><td><code>acquisition_list_source_5.currency</code></td><td><code>acquisition_list_source_5.price</code></td><td><code>active_job_postings</code></td></tr><tr><td><code>active_job_postings.job_posting_title</code></td><td><code>average_visit_duration_seconds</code></td><td><code>avg_tenure_by_department_months</code></td></tr><tr><td><code>avg_tenure_by_seniority_months</code></td><td><code>bounce_rate</code></td><td><code>canonical_professional_network_url</code></td></tr><tr><td><code>categories_and_keywords</code></td><td><code>company_emails</code></td><td><code>company_employee_reviews_aggregate_score</code></td></tr><tr><td><code>company_employee_reviews_count</code></td><td><code>company_legal_name</code></td><td><code>company_locations_full</code></td></tr><tr><td><code>company_locations_full.city</code></td><td><code>company_locations_full.country</code></td><td><code>company_locations_full.country_iso_2</code></td></tr><tr><td><code>company_locations_full.country_iso_3</code></td><td><code>company_locations_full.is_primary</code></td><td><code>company_locations_full.latitude</code></td></tr><tr><td><code>company_locations_full.location_address</code></td><td><code>company_locations_full.longitude</code></td><td><code>company_locations_full.regions</code></td></tr><tr><td><code>company_locations_full.state</code></td><td><code>company_locations_full.street</code></td><td><code>company_locations_full.zip_code</code></td></tr><tr><td><code>company_logo</code></td><td><code>company_logo_url</code></td><td><code>company_name</code></td></tr><tr><td><code>company_name_alias</code></td><td><code>company_phone_numbers</code></td><td><code>competitors</code></td></tr><tr><td><code>competitors.company_name</code></td><td><code>competitors_websites</code></td><td><code>financial_website_url</code></td></tr><tr><td><code>demo_available</code></td><td><code>departures_count</code></td><td><code>description</code></td></tr><tr><td><code>description_enriched</code></td><td><code>description_metadata_raw</code></td><td><code>discord_url</code></td></tr><tr><td><code>documentation_exist</code></td><td><code>employee_reviews_score_breakdown</code></td><td><code>employee_reviews_score_distribution</code></td></tr><tr><td><code>employees_count</code></td><td><code>employees_count_breakdown_by_department</code></td><td><code>employees_count_breakdown_by_region</code></td></tr><tr><td><code>employees_count_breakdown_by_seniority</code></td><td><code>employees_count_inferred</code></td><td><code>facebook_url</code></td></tr><tr><td><code>followers_count_professional_network</code></td><td><code>followers_count_owler</code></td><td><code>founded_year</code></td></tr><tr><td><code>free_trial_available</code></td><td><code>funding_rounds</code></td><td><code>funding_rounds.amount_raised</code></td></tr><tr><td><code>funding_rounds.amount_raised_currency</code></td><td><code>funding_rounds.announced_date</code></td><td><code>funding_rounds.investors</code></td></tr><tr><td><code>funding_rounds.num_investors</code></td><td><code>funding_rounds.num_partners</code></td><td><code>funding_rounds.type</code></td></tr><tr><td><code>github_url</code></td><td><code>hq_apartment</code></td><td><code>hq_city</code></td></tr><tr><td><code>hq_country</code></td><td><code>hq_country_iso2</code></td><td><code>hq_country_iso3</code></td></tr><tr><td><code>hq_full_address</code></td><td><code>hq_latitude</code></td><td><code>hq_location</code></td></tr><tr><td><code>hq_longitude</code></td><td><code>hq_region</code></td><td><code>hq_state</code></td></tr><tr><td><code>hq_street</code></td><td><code>hq_suite</code></td><td><code>hq_zipcode</code></td></tr><tr><td><code>income_statements</code></td><td><code>income_statements.cost_of_goods_sold</code></td><td><code>income_statements.cost_of_goods_sold_currency</code></td></tr><tr><td><code>income_statements.earnings_per_share</code></td><td><code>income_statements.ebit</code></td><td><code>income_statements.ebit_margin</code></td></tr><tr><td><code>income_statements.ebitda</code></td><td><code>income_statements.ebitda_margin</code></td><td><code>income_statements.gross_profit</code></td></tr><tr><td><code>income_statements.gross_profit_margin</code></td><td><code>income_statements.income_tax_expense</code></td><td><code>income_statements.interest_expense</code></td></tr><tr><td><code>income_statements.interest_income</code></td><td><code>income_statements.net_income</code></td><td><code>income_statements.period_display_end_date</code></td></tr><tr><td><code>income_statements.period_end_date</code></td><td><code>income_statements.period_type</code></td><td><code>income_statements.pre_tax_profit</code></td></tr><tr><td><code>income_statements.revenue</code></td><td><code>income_statements.total_operating_expense</code></td><td><code>industry</code></td></tr><tr><td><code>instagram_url</code></td><td><code>ipo_date</code></td><td><code>ipo_share_price</code></td></tr><tr><td><code>ipo_share_price_currency</code></td><td><code>is_downloadable</code></td><td><code>is_public</code></td></tr><tr><td><code>key_employee_change_events</code></td><td><code>key_employee_change_events.employee_change_event_date</code></td><td><code>key_employee_change_events.employee_change_event_name</code></td></tr><tr><td><code>key_employee_change_events.employee_change_event_url</code></td><td><code>key_executive_arrivals</code></td><td><code>key_executive_arrivals.member_full_name</code></td></tr><tr><td><code>key_executive_arrivals.member_position_title</code></td><td><code>key_executive_departures</code></td><td><code>key_executive_departures.departure_date</code></td></tr><tr><td><code>key_executive_departures.member_full_name</code></td><td><code>key_executive_departures.member_position_title</code></td><td><code>key_executive_departures.parent_id</code></td></tr><tr><td><code>key_executives</code></td><td><code>key_executives.member_full_name</code></td><td><code>key_executives.member_position_title</code></td></tr><tr><td><code>key_executives.parent_id</code></td><td><code>last_funding_round</code></td><td><code>professional_network_url</code></td></tr><tr><td><code>mobile_apps_exist</code></td><td><code>naics_codes</code></td><td><code>online_reviews_exist</code></td></tr><tr><td><code>ownership_status</code></td><td><code>pages_per_visit</code></td><td><code>parent_company_information</code></td></tr><tr><td><code>pinterest_url</code></td><td><code>pricing_available</code></td><td><code>product_pricing_summary</code></td></tr><tr><td><code>product_pricing_summary.price</code></td><td><code>product_reviews_aggregate_score</code></td><td><code>product_reviews_count</code></td></tr><tr><td><code>product_reviews_score_distribution</code></td><td><code>reddit_url</code></td><td><code>revenue_annual</code></td></tr><tr><td><code>revenue_annual_range</code></td><td><code>revenue_quarterly</code></td><td><code>sic_codes</code></td></tr><tr><td><code>similarly_ranked_websites</code></td><td><code>size_range</code></td><td><code>status</code></td></tr><tr><td><code>stock_information</code></td><td><code>stock_information.closing_price</code></td><td><code>stock_information.currency</code></td></tr><tr><td><code>stock_information.marketcap</code></td><td><code>stock_ticker</code></td><td><code>technologies_used</code></td></tr><tr><td><code>technologies_used.last_verified_at</code></td><td><code>tiktok_url</code></td><td><code>top_next_companies</code></td></tr><tr><td><code>top_next_companies.company_name</code></td><td><code>top_next_companies.count</code></td><td><code>top_previous_companies</code></td></tr><tr><td><code>top_previous_companies.company_name</code></td><td><code>top_previous_companies.count</code></td><td><code>top_topics</code></td></tr><tr><td><code>total_website_visits_monthly</code></td><td><code>twitter_url</code></td><td><code>type</code></td></tr><tr><td><code>visits_breakdown_by_country</code></td><td><code>visits_breakdown_by_country.country</code></td><td><code>visits_breakdown_by_country.percentage</code></td></tr><tr><td><code>visits_breakdown_by_country.percentage_monthly_change</code></td><td><code>website</code></td><td><code>website_alias</code></td></tr><tr><td><code>website_domain</code></td><td><code>youtube_url</code></td><td></td></tr></tbody></table>

</details>

## Company webhooks

### Subscribe using IDs

Get notifications if one of webhook triggers has been updated:

```json
curl -X 'POST' \
  'https://api.coresignal.com/cdapi/v2/subscriptions/company_multi_source/ids' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: multipart/form-data' \
  -d '{
  "webhook_url": "{your_webhook_url}",
  "ids": [1, 222, 3456]
}'
```

Subscribe by fields and track `company_name` and `key_employee_change_events` changes:

```json
curl -X 'POST' \
  'https://api.coresignal.com/cdapi/v2/subscriptions/company_multi_source/ids' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: multipart/form-data' \
  -d '{
  "webhook_url": "{your_webhook_url}",
  "ids": [1, 222, 3456],
  "tracked_fields": ["company_name", "key_employee_change_events"]
}'
```

### Subscribe using Elasticsearch DSL

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Company API Elasticsearch DSL</td><td><a href="/company-data/api/elasticsearch-dsl.md#elasticsearch-schema">Elasticsearch DSL</a></td></tr></tbody></table>

Get notifications if one of webhook triggers has been updated:

```json
curl -X 'POST' \
  'https://api.coresignal.com/cdapi/v2/subscriptions/company_multi_source/es_dsl' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: application/json' \
  -d '{
  "webhook_url": "{your_webhook_url}",
  "es_dsl_query": {
    "query": {
      "bool": {
        "filter": [
          {
            "range": {
              "employees_count_change.change_quarterly_percentage": {
                "gte": 0
              }
            }
          }
        ]
     }
   }
}'
```

Subscribe by fields and track `company_name` and `competitors` changes:

```json
curl -X 'POST' \
  'https://api.coresignal.com/cdapi/v2/subscriptions/company_multi_source/es_dsl' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: application/json' \
  -d '{
  "webhook_url": "{your_webhook_url}",
  "es_dsl_query": {
    "query": {
      "bool": {
        "filter": [
          {
            "range": {
              "employees_count_change.change_quarterly_percentage": {
                "gte": 0
              }
            }
          }
        ]
     }
  },
  "tracked_fields": ["company_name", "competitors"]
}'
```

## 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:

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Company API collection endpoint</td><td><a href="/company-data/api/collect.md">Collect</a></td></tr></tbody></table>

### 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:

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Company API Bulk Collect endpoints</td><td><a href="/company-data/api/bulk-collect.md">Bulk Collect</a></td></tr></tbody></table>

Follow the instructions here to successfully collect the company data:

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>IDs request</td><td><a href="/api-introduction/requests/bulk-collect/post-requests.md#id-file-requests">POST Requests</a></td></tr><tr><td>GET the file name</td><td><a href="/api-introduction/requests/bulk-collect/get-requests.md#get-the-file-name">GET Requests</a></td></tr><tr><td>GET the file</td><td><a href="/api-introduction/requests/bulk-collect/get-requests.md#get-the-file">GET Requests</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.coresignal.com/company-data/api/webhooks.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.