Skip to main content
WhiteWhale can POST events to any URL you specify whenever a signal fires or an account is added from suggestions. Use webhooks to pipe data into Clay, trigger automations, update internal tools, or build custom CRM integrations.

​
Setup

There are two ways to register a webhook URL. Option 1: In the platform: Go to Settings → API & Webhooks → paste your endpoint URL and save. Option 2: Via the API: POST /v1/set_webhook with your URL in the request body. 
curl -X POST https://app.getwhitewhale.com/v1/set_webhook \
  -H "api-key: YOUR_API_KEY" \
  -H "user: you@company.com" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url": "https://your-endpoint.com/whitewhale"}'
One webhook URL per account. The same endpoint receives all event types.

​
Testing your webhook

Before going live, send a test payload to your endpoint using the API. 
curl -X POST https://app.getwhitewhale.com/v1/test_webhook \
  -H "api-key: YOUR_API_KEY" \
  -H "user: you@company.com" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "account.signal",
    "spoof_payload": true
  }'
ParameterDescription
event_type"account.upload" or "account.signal"
spoof_payloadtrue returns a fake payload with the correct structure. Requires at least one signal on an account.
icp_nameOptional. If provided, returns a real signal and account name instead of spoofed data.
The payload returned in the API response is unsigned. The payload delivered to your actual webhook endpoint will be signed.

​
Event types

WhiteWhale sends two types of events.
Sent every morning when a new signal match is found. This is the most common event type and the primary source of daily signal data.Payload structure:
{
  "event": "account.signal",
  "event_time": "2025-06-10T08:00:00Z",
  "data": [
    {
      "owner_email": "rep@company.com",
      "account": "acme.com",
      "signal_name": "New CRO Hired",
      "source": "https://techcrunch.com/...",
      "pub_date": "2025-06-09T14:30:00Z",
      "why_now": "Acme just brought in a new CRO from Salesforce who has publicly committed to overhauling their outbound motion over the next 90 days.",
      "full_signal_summary": "...",
      "crm_account_id": "hs_123456",
      "article_summary": {
        "headline": "Acme Corp Appoints New Chief Revenue Officer",
        "quotes": ["We're rebuilding our GTM from the ground up"],
        "relevant_facts": ["New CRO previously led sales at Salesforce", "Acme targeting 3x revenue growth"],
        "one_sentence_summary": "Acme hired a new CRO with a mandate to overhaul their sales motion.",
        "signal_summary": "...",
        "document_type": "news_article"
      }
    }
  ]
}
Signal payload fields:
FieldTypeDescription
owner_emailstringWhiteWhale user who owns the account
accountstringAccount domain
signal_namestringName of the signal that fired
sourcestringURL of the source document
pub_datedatetimePublication date of the source
why_nowstringWhiteWhale’s Why Now summary for the account
full_signal_summarystringExtended summary of the signal
crm_account_idstringCRM account ID if CRM is connected
article_summary.headlinestringHeadline of the source document
article_summary.quotesarrayKey quotes from the source
article_summary.relevant_factsarrayKey facts extracted from the source
article_summary.one_sentence_summarystringOne-line summary of the source
article_summary.document_typestringType of source (news article, job posting, earnings call, etc.)
Sent when a new account is uploaded or when Account Suggestions finishes pre-scoring an account. Returns the full account object including all signal data.Payload structure:
{
  "event": "account.upload",
  "event_time": "2025-06-10T08:00:00Z",
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Acme Corp",
      "icp_name": "Master",
      "icp_id": "9f0979ca-5f3a-40c5-afe5-41cfd70cde6a",
      "owner_email": "rep@company.com",
      "summary": "Acme is expanding into enterprise and just hired a new CRO...",
      "scaled_score": 74,
      "status": "farsight",
      "account_data": {
        "full_name": "Acme Corporation, Inc.",
        "linkedin_url": "https://linkedin.com/company/acme",
        "industry": "Software",
        "li_employees": 320,
        "location": {}
      },
      "signals": [...],
      "signal_list": ["New CRO Hired", "Hiring SDRs", "Series B Funding"]
    }
  ]
}
Key account fields:
FieldTypeDescription
idstringWhiteWhale account UUID
scaled_scorenumberAccount score 0–100. If status is farsight, this is a prediction score.
statusstringactive, archived, or farsight
summarystringWhy Now summary
signal_listarrayNames of all signals currently matching this account
signalsarrayFull signal answer objects with sources, quotes, and dates
account_data.li_employeesintegerEmployee count from LinkedIn
account_data.linkedin_urlstringCompany LinkedIn URL

​
Timing

EventWhen it fires
account.signalDaily, each morning when new signal matches are found
account.uploadImmediately when an account is uploaded or activated, and when Account Suggestions finishes pre-scoring

API Reference

Full endpoint reference including /v1/set_webhook and /v1/test_webhook.

Clay

Use webhooks to pipe WhiteWhale data directly into Clay.