Skip to main content
WEBHOOK

Authorizations

api-key
string
header
required

Body

application/json

The New Competitor Deal webhook body (payload version v2): one signal, with its contact, company, account and CRM context, flat.

signal_id
string

Stable id of this signal. The webhook sends the same id.

account_id
string

Stable id of the account, e.g. "domain:acme.com". Use it in /accounts/{account_id} paths (URL-encoded).

contact_name
string

Full name.

contact_job_title
string

Current job title.

contact_role
string | null

Role in a purchase (e.g. champion, decision_maker). Null when not classified.

contact_bucket
string | null

How strong a fit the person is (strong, potential, weak). Null when not classified.

contact_linkedin_url
string

Social profile URL.

contact_work_email
string

Work email this workspace already enriched. Only with include=contact_info; empty means not enriched yet.

contact_phone_number
string

Phone this workspace already enriched. Only with include=contact_info.

contact_country
string

The contact's country, ISO 3166-1 alpha-2. Webhook only for now.

company_name
string

Company name.

company_domain
string

Website domain.

company_linkedin_url
string

The company's page on the social network. Webhook only for now.

company_size
string

Employee band, e.g. "1001-5000".

company_industry
string

Industry.

company_hq_country
string

Headquarters country, ISO 3166-1 alpha-2 (e.g. "US").

signal_summary
string

One sentence: who did what with whom, e.g. "Engaged with a VP of Sales at HubSpot".

signal_post_url
string

The post the interaction was on, when there is one. Empty otherwise.

signal_freshness
string

Freshness of this signal.

signal_priority
string

The account's priority. The API calls it account_priority.

first_signal_date
string

The account's first dated signal.

latest_signal_date
string

The account's latest dated signal.

competitor_name
string

The competitor the signal involves.

competitor_rep_title
string

Job title of the competitor's employee in the signal. Names are not published.

account_competitors
string

Every competitor with signals at this account, comma-joined ("Common Room, G2"), as the webhook sends it.

account_competitor_cycle_stage
string

Where we infer the account is in a buying cycle with a competitor. An inference from signals, not CRM data.

account_competitor_cycle_reason
string

Why we inferred that stage.

account_icp_fit
boolean

The account matches your ideal customer profile.

account_icp_fit_reason
string

Why it fits. Empty when account_icp_fit is false.

account_confirmed_competitor
string

A competitor the account's own job posts or filings say it uses, with the source: " - Source: ". Empty when none.

account_confirmed_project
string

A project in the account's job posts or filings that what you sell would help: "

- Source: ". Empty when none.

The recommended outreach as one label, e.g. "Email + Call". Empty when there is no recommendation.

Email is recommended.

Social outreach is recommended.

A call is recommended.

crm_account_url
string

Link to the account's own CRM record. Empty when it is not in your CRM.

crm_account_owner_name
string

CRM account owner.

crm_account_owner_email
string

Their email.

crm_is_customer
boolean | null

The account is your customer now. Null when the CRM lookup failed.

crm_has_open_opp
boolean | null

The account has an open opportunity. Null when unknown.

crm_latest_opp_id
string

CRM id of the latest opportunity.

crm_latest_opp_stage
string

Its stage as your CRM labels it, e.g. "S1: Discover (SAO)".

crm_latest_opp_amount
number | null

Its amount.

crm_latest_opp_close_date
string

Its close date (expected close while open).

crm_latest_opp_owner_name
string

Its owner.

crm_latest_opp_owner_email
string

Their email.

Response

200

Any 2xx acknowledges delivery.