Trakkr Ai Webhooks

generated: '2026-10-30'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://trakkr.ai/learn/api/endpoints/webhooks
sources:
- https://trakkr.ai/learn/api/endpoints/webhooks
description: Webhooks allow real‑time HTTP notifications when events occur in a Trakkr account.
events:
- event: visibility_changed
  description: Your visibility score moved beyond the alert threshold.
- event: rank_changed
  description: A tracked competitor crossed your brand.
- event: competitor_changed
  description: A competitor's visibility moved beyond the alert threshold.
- event: competitor_added
  description: A new competitor was detected or added.
- event: report_completed
  description: A report finished; report_type is daily for the daily visibility scan, or the document type when you call POST /get-reports.
- event: citation_gained
  description: Brand gained a new citation source.
- event: citation_lost
  description: A page that was being cited stopped appearing.
- event: page_cited
  description: One of your pages was cited by an AI model.
- event: perception_changed
  description: A perception score moved.
- event: narrative_shift
  description: AI changed how it positions or talks about the brand.
- event: descriptor_change
  description: The words AI uses to describe the brand turned over.
- event: goal_achieved
  description: A perception goal reached its target.
- event: goal_regression
  description: A perception goal slipped off track.
- event: opportunity_found
  description: A citation opportunity was found.
- event: prompt_gap
  description: AI answers a prompt with competitors and not you.
- event: article_generated
  description: An article finished generating.
- event: article_published
  description: An article was marked published.
- event: campaign_completed
  description: Every article in a campaign finished.
- event: research_completed
  description: A research scan finished.
- event: audit_score_dropped
  description: Site AI readiness score dropped.
- event: crawler_spike
  description: AI crawler traffic spiked above its normal daily average.
- event: crawler_first_seen
  description: An AI bot crawled one of your pages for the first time.
- event: crawler_silent
  description: A previously active AI bot stopped visiting.
- event: crawler_error_surge
  description: AI crawlers started hitting broken pages.
- event: action_created
  description: A new action landed in the queue.
- event: action_completed
  description: An action was marked complete.
- event: client_invite_accepted
  description: A client accepted their invite to your white‑label portal.
- event: client_access_revoked
  description: A client's portal access was revoked.
delivery:
  signature: signing_secret is provided per webhook (auto‑generated if omitted) and can be used to verify payload signatures.
  content_type: application/json
note: 'Authentication for the webhook endpoint can be configured per webhook via auth_type: "none", "bearer", "basic", or "api_key" (Bearer token
  sent in Authorization header, Basic Auth via username/password, API key via custom header).'
docs: https://trakkr.ai/learn/api/endpoints/webhooks