Sage Infrastructure Solutions Group IncSage Infrastructure Solutions Group IncLoading…

Sage Infrastructure Solutions Group Inc

Webhooks

Webhooks

Webhooks send exposures to your own systems — a SIEM, a ticketing tool, a chat channel, an automation — the moment they happen. FathomWatch POSTs a signed JSON message to your URL for each event you subscribe to.

Webhooks are part of the Organization plan. Anyone in the organization can manage its webhooks.

Create a webhook

  1. Open Webhooks in the sidebar (in your organization's context).
  2. Enter a label, the destination URL, the leak type to send (or All types) and the events.
  3. Select Add webhook. The signing secret is shown once — store it in your receiver's configuration. If you lose it, delete the webhook and create a new one.
  4. Select Send test to send a test event, and check Last delivery for the result.

The URL must be http or https and reachable from the internet: addresses that resolve to private, loopback or link-local networks are refused. Use https.

Events

EventSent when
new_leakA new exposure arrives (credentials not reported before).
status_changedSomeone changes an exposure's status.
recurrence_seenCredentials that were already reported turn up again in new data.
testYou select Send test.

Request

POST /your/path HTTP/1.1
Content-Type: application/json
User-Agent: FathomWatch-Webhook/1
X-FathomWatch-Event: new_leak
X-FathomWatch-Signature: sha256=<64 hex characters>

Every message has these fields, plus the event's own:

FieldTypeDescription
eventstringnew_leak, status_changed, recurrence_seen or test.
occurred_atstringWhen FathomWatch sent it (RFC 3339, UTC).
org_idstringYour organization's ID.

new_leak

{
  "event": "new_leak",
  "occurred_at": "2026-10-03T14:02:12Z",
  "org_id": "organizations:abc123",
  "leak": {
    "id": "leak_record:7k2m9x4qpz",
    "leak_type": "InfoStealers",
    "status": "new",
    "source": "telegram_infostealer",
    "item_id": "logs/5A1F3.zip",
    "received_at": "2026-10-03T14:02:11Z",
    "credential_count": 2,
    "url": "https://fathom.saas.sageisg.com/leaks/leak_record%3A7k2m9x4qpz",
    "part": 1,
    "parts": 1
  },
  "credentials": [
    {
      "account": "maya.chen@example.com",
      "url": "https://login.microsoftonline.com/",
      "password_masked": "Harbor••••••",
      "sha1": "427F61F56676C182A1D531BA314A83773DFCE23A",
      "times_seen": 1
    }
  ]
}
FieldDescription
leak.idThe exposure's ID — stable across status_changed and recurrence_seen.
leak.urlLink to the exposure in FathomWatch (sign-in required).
leak.credential_countCredentials stored for this part of the exposure.
leak.part, leak.partsLarge exposures are split into parts of up to 2,000 credentials; each part is its own new_leak.
credentials[].accountThe affected account, in full.
credentials[].urlThe site the login was saved for.
credentials[].password_maskedThe first few characters of the password, then ••••••. The full password is never sent or stored.
credentials[].sha1Uppercase hex SHA-1 of the password, to check it against public breached-password lists without revealing it.

status_changed

{
  "event": "status_changed",
  "occurred_at": "2026-10-03T15:20:41Z",
  "org_id": "organizations:abc123",
  "leak": {
    "id": "leak_record:7k2m9x4qpz",
    "leak_type": "InfoStealers",
    "status": "investigating",
    "url": "https://fathom.saas.sageisg.com/leaks/leak_record%3A7k2m9x4qpz"
  },
  "from_status": "new",
  "to_status": "investigating",
  "note": "Laptop sent to IT for a rebuild.",
  "actor": "priya.n@example.com"
}

Statuses are new, investigating, resolved and dismissed. note is empty when none was given; actor is the email of the person who made the change.

recurrence_seen

{
  "event": "recurrence_seen",
  "occurred_at": "2026-10-04T09:11:03Z",
  "org_id": "organizations:abc123",
  "leak": {
    "id": "leak_record:9q4w2e8rty",
    "leak_type": "InfoStealers",
    "source": "telegram_infostealer",
    "item_id": "logs/8A74A.zip",
    "recurrences": 3,
    "url": "https://fathom.saas.sageisg.com/leaks/leak_record%3A9q4w2e8rty"
  }
}

recurrences is how many already-reported credentials were seen again. No credentials are included: you already received them in a new_leak.

test

{
  "event": "test",
  "occurred_at": "2026-10-03T14:00:00Z",
  "org_id": "organizations:abc123",
  "message": "This is a FathomWatch webhook test delivery."
}

Verify the signature

X-FathomWatch-Signature is sha256= followed by the hex HMAC-SHA256 of the raw request body, keyed with your signing secret (used as-is, as text — don't decode it).

  1. Read the raw body before parsing it as JSON.
  2. Compute the HMAC and compare it with the header in constant time.
  3. Reject anything that doesn't match with 401.

Working receivers in Python, Go and Node.js: Webhook examples.

Delivery

  • Answer with any 2xx within 10 seconds. Do slow work after answering.
  • On a timeout, a network error or a non-2xx answer, FathomWatch tries up to 3 times (waiting 1 second, then 2). After the third failure the message is dropped and Last delivery shows the failure.
  • A retry resends the identical body, so you may receive the same message more than once: use a hash of the body to ignore duplicates.
  • Messages can arrive in any order. Use leak.id to tie events about the same exposure together.
  • Don't rely on webhooks as your only record: the leak inbox and Export CSV always have everything.