Warmly · AsyncAPI Specification

Warmly Webhooks

Version

View Spec View on GitHub CompanySalesMarketingIntent DataRevenue OrchestrationWebsite Visitor IdentificationAI AgentsGo To MarketMCPLead GenerationCRMAsyncAPIWebhooksEvents

AsyncAPI Specification

warmly-webhooks.yml Raw ↑
generated: '2026-08-13'
method: searched
type: Webhooks
source: https://help.warmly.ai/articles/7839413626-setting-up-webhooks
docs: https://help.warmly.ai/articles/7839413626-setting-up-webhooks
asyncapi_published: false
asyncapi_note: >-
  Warmly publishes no AsyncAPI document. This file captures the documented webhook
  surface from the provider's own help centre and is deliberately NOT written as an
  AsyncAPI spec, because none exists to harvest.
summary: >-
  Warmly's event surface is outbound-only and signal-driven. Seven intent signals can
  each be routed to an HTTPS endpoint, either as a single unfiltered destination on
  the free tier or as filtered "Send Company to Webhook" / "Send Contact to Webhook"
  steps inside Orchestrator workflows on paid tiers. Payloads are rich — full contact,
  company and signal blocks — but the delivery contract is thin: Warmly documents no
  HTTP method, no signing scheme, no delivery headers and no retry policy, so a
  receiver cannot verify that a payload actually came from Warmly.
configuration:
  free_tier:
    path: Settings > Webhooks
    destinations: 1
    filtering: none (all unfiltered website visitors)
  paid_tier:
    path: Orchestrator workflows
    destinations: unlimited
    filtering: by audience and intent signal type
    steps: [Send Company to Webhook, Send Contact to Webhook]
  transport: HTTPS URL supplied by the subscriber
events:
- name: website-visit-contact
  description: An identified contact visited your site.
  payload_blocks: [contact, company, signal]
- name: website-visit-company
  description: An identified company visited your site.
  payload_blocks: [company, signal]
- name: bombora-research-intent
  description: An ICP company is researching competitor or market keywords.
  payload_blocks: [company, research-topics]
  note: Carries research topics with confidence scores in place of the standard signal block.
- name: social-engager
  description: A contact engaged with your orchestrated social content.
  payload_blocks: [contact, company, signal]
- name: job-change
  description: A customer champion moved to another target company.
  payload_blocks: [contact, company]
- name: new-hire
  description: A typical buyer profile was hired at an ICP company.
  payload_blocks: [contact, company]
- name: job-opening
  description: A company is hiring for a specific role.
  payload_blocks: [company]
- name: execution-status
  description: Status updates for asynchronous agent-tool executions (e.g. CRM write tools).
  docs: https://www.warmly.ai/launches/warmly-mcp-and-api-are-live
  payload_blocks: [execution]
  note: Referenced in the API launch material; no payload schema is published.
payload:
  guaranteed_fields:
    contact: [email]
    company: [domain]
  contact_fields: [linkedInUrl, businessEmail, name, title, location, companyDetails, logo]
  company_fields: [domain, legalName, industry, sector, employeeCount, revenueEstimate, techStack, socialHandles, location, foundingYear]
  signal_fields: [seenAt, referrer, capturedUrl, sessionId, confidenceScore, ipLocation, utmParameters, pagesViewed, timeSpent, formFills, chatLogs]
  null_handling: Enriched fields that are unavailable return null or an empty string.
delivery_contract:
  http_method: not published
  headers: not published
  signing: not published
  authentication: not published
  retries: not published
  ordering: not published
  gap: >-
    None of the delivery semantics are documented. There is no signature header, no
    shared secret and no replay-protection mechanism described, which means a
    subscriber has no published way to authenticate an inbound Warmly payload.
middleware:
- {name: Zapier, docs: 'https://help.warmly.ai/articles/6752668157-warmly-zapier-integration'}
- {name: Make, docs: 'https://help.warmly.ai/articles/6113850353-warmly-make-integration'}
- {name: Google Sheets, docs: 'https://help.warmly.ai/articles/1250540603-send-warmly-intent-signals-to-google-sheets-via-webhook'}
- {name: Microsoft Teams via Power Automate, docs: 'https://help.warmly.ai/articles/1481974657-microsoft-teams-integration-real-time-visitor-notifications'}
inbound_events:
  supported: false
  note: Warmly exposes no inbound event ingestion, streaming, SSE or message-queue surface. The event surface is outbound webhooks only.