> ## Documentation Index
> Fetch the complete documentation index at: https://docs.letterdrop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> The New Competitor Deal webhook, which shares the API's vocabulary.

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

```json theme={null}
{
  "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"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.