Webhooks

The same data can be pushed to you. Add a Send to Webhook step to a Competitor Deal workflow and choose payload version v2 (the default for new steps). Each signal is then POSTed to your URL as one WebhookSignal: the signal with its contact, company, account and CRM context, flat, using the same field names and values as this API.

Delivery
Request	`POST`, JSON body, one signal per request. Custom fields the step adds come after the standard fields.
Authenticity	Every request carries your workspace’s `api-key` header; compare it with your key.
Success	Any 2xx within 30 seconds.
Retries	Any other answer, a timeout or a JSON error body is retried every 10 minutes: up to 3 times for errors, up to 6 times (about an hour) when you answer 429. After that the delivery is dropped and the workflow reports it.

The API and the webhook differ in two places: the webhook calls the account’s priority signal_priority (the API’s account_priority), and it also sends contact_country, which the API does not have yet.

Example payload

{
  "signal_id": "6aa5558899db31a0da3c9465",
  "account_id": "domain:acme.com",
  "contact_name": "Jane Doe",
  "contact_job_title": "VP Marketing",
  "contact_role": "champion",
  "contact_bucket": "strong",
  "contact_linkedin_url": "https://example.com/people/jane-doe",
  "contact_work_email": "jane.doe@acme.com",
  "contact_phone_number": "+12025550123",
  "contact_country": "US",
  "company_name": "Acme",
  "company_domain": "acme.com",
  "company_linkedin_url": "https://example.com/companies/acme",
  "company_size": "1001-5000",
  "company_industry": "Software Development",
  "company_hq_country": "US",
  "signal_summary": "Evaluating PiedPiper because...",
  "signal_post_url": "",
  "signal_freshness": "Recent",
  "signal_priority": "High",
  "first_signal_date": "2024-10-12",
  "latest_signal_date": "2024-10-20",
  "competitor_name": "PiedPiper",
  "competitor_rep_title": "Vice President of Sales",
  "account_competitors": "PiedPiper, Globex",
  "account_competitor_cycle_stage": "Active Sales Cycle",
  "account_competitor_cycle_reason": "A decision maker and an end user seem to be involved in evaluating PiedPiper",
  "account_icp_fit": true,
  "account_icp_fit_reason": "The account matches the industries, company sizes, and buying patterns seen in closed-won customers.",
  "account_confirmed_competitor": "PiedPiper - Source: https://jobs.example.com/acme/revops-manager",
  "account_confirmed_project": "Migrating the CRM from PiedPiper to Salesforce - Source: https://jobs.example.com/acme/salesforce-architect",
  "recommended_channels": "Email + Call",
  "recommended_email": true,
  "recommended_linkedin": false,
  "recommended_call": true,
  "crm_account_url": "https://app.hubspot.com/contacts/12345678/company/17598685516",
  "crm_account_owner_name": "Alex Owner",
  "crm_account_owner_email": "alex@example.com",
  "crm_is_customer": false,
  "crm_has_open_opp": true,
  "crm_latest_opp_id": "31234567890",
  "crm_latest_opp_stage": "Discovery",
  "crm_latest_opp_amount": 25000,
  "crm_latest_opp_close_date": "2025-12-15",
  "crm_latest_opp_owner_name": "Alex Owner",
  "crm_latest_opp_owner_email": "alex@example.com"
}

Get started

Using the API

Webhooks

Example payload

​Example payload

Example payload