Alerts

Alerts raised by the LeadConduit alert detection engine: recipient failure and skip spikes, source rejection spikes, flows that stopped posting, category rejections (duplicates, TrustedForm issues), and new sources. The engine evaluates each account's activity against its own baselines; alerts resolve automatically when the condition clears.

Alert

An active alert raised by the LeadConduit alert detection engine for this account. Each alert has a stable key for its underlying condition: while the condition persists the same key is returned on every read (with severity, message, and data refreshed), and first_seen_at marks when the condition was first detected.

key
string

Stable identifier for the alert condition (type:account:entity, zero-run alerts also carry the run start date)

type
string

Alert type

Enum: "recipient-failure" "recipient-skip" "source-rejects" "no-leads" "new-source" "duplicate-leads" "invalid-email" "invalid-phone" "missing-tf-cert" "tf-failures"
kind
string or null

Sub-classification of the alert, when the type has one (e.g. failure vs error for source rejections)

severity
string

Alert severity

Enum: "critical" "serious" "warning" "info"
message
string

One-line headline describing the condition

detail
string

Diagnostic second line with the supporting numbers

null or ID (string)

ID of the flow the alert concerns; null for alerts that are not flow-scoped (e.g. new-source)

flow_name
string or null

Name of the flow the alert concerns, when flow-scoped

entity_id
string or null

ID of the source or recipient entity the alert concerns; null for flow-level alerts (e.g. no-leads)

entity_name
string or null

Name of the source or recipient entity the alert concerns

recipient_id
string or null

Recipient entity ID for category alerts backed by an integration step (deep-link support)

outcome
string or null

The step outcome counted by a category alert (e.g. skip for missing TrustedForm certificates)

time_zone
string

The account's IANA time zone, for rendering timestamps in the account's local day

first_seen_at
string <date-time>

When the alert condition was first detected (stable while the condition persists)

last_seen_at
string <date-time>

When the alert condition was last confirmed by the detector

object

Type-specific supporting metrics (rates, baselines, counts). Aggregate numbers only, never lead data.

{
  • "key": "recipient-failure:42:5e8b6f...|5f1c...|leadconduit-custom.outbound.form",
  • "type": "recipient-failure",
  • "kind": "failure",
  • "severity": "critical",
  • "message": "100% of submissions to CRM One in Web Leads are failing",
  • "detail": "60 of 60 submissions today · typical last 7 days: 2% · most common reason: Timeout",
  • "flow_id": { },
  • "flow_name": "Web Leads",
  • "entity_id": "5e8b6f91f0d12766e2bfee51",
  • "entity_name": "CRM One",
  • "recipient_id": "string",
  • "outcome": "skip",
  • "time_zone": "America/Chicago",
  • "first_seen_at": "2019-08-24T14:15:22Z",
  • "last_seen_at": "2019-08-24T14:15:22Z",
  • "data": {
    • "rate": 1,
    • "baseline_rate": 0.02,
    • "total": 60
    }
}

Alerts

The account's active alerts, sorted by severity and then by today's affected volume.

Array
key
string

Stable identifier for the alert condition (type:account:entity, zero-run alerts also carry the run start date)

type
string

Alert type

Enum: "recipient-failure" "recipient-skip" "source-rejects" "no-leads" "new-source" "duplicate-leads" "invalid-email" "invalid-phone" "missing-tf-cert" "tf-failures"
kind
string or null

Sub-classification of the alert, when the type has one (e.g. failure vs error for source rejections)

severity
string

Alert severity

Enum: "critical" "serious" "warning" "info"
message
string

One-line headline describing the condition

detail
string

Diagnostic second line with the supporting numbers

null or ID (string)

ID of the flow the alert concerns; null for alerts that are not flow-scoped (e.g. new-source)

flow_name
string or null

Name of the flow the alert concerns, when flow-scoped

entity_id
string or null

ID of the source or recipient entity the alert concerns; null for flow-level alerts (e.g. no-leads)

entity_name
string or null

Name of the source or recipient entity the alert concerns

recipient_id
string or null

Recipient entity ID for category alerts backed by an integration step (deep-link support)

outcome
string or null

The step outcome counted by a category alert (e.g. skip for missing TrustedForm certificates)

time_zone
string

The account's IANA time zone, for rendering timestamps in the account's local day

first_seen_at
string <date-time>

When the alert condition was first detected (stable while the condition persists)

last_seen_at
string <date-time>

When the alert condition was last confirmed by the detector

object

Type-specific supporting metrics (rates, baselines, counts). Aggregate numbers only, never lead data.

[
  • {
    • "key": "recipient-failure:42:5e8b6f...|5f1c...|leadconduit-custom.outbound.form",
    • "type": "recipient-failure",
    • "kind": "failure",
    • "severity": "critical",
    • "message": "100% of submissions to CRM One in Web Leads are failing",
    • "detail": "60 of 60 submissions today · typical last 7 days: 2% · most common reason: Timeout",
    • "flow_id": { },
    • "flow_name": "Web Leads",
    • "entity_id": "5e8b6f91f0d12766e2bfee51",
    • "entity_name": "CRM One",
    • "recipient_id": "string",
    • "outcome": "skip",
    • "time_zone": "America/Chicago",
    • "first_seen_at": "2019-08-24T14:15:22Z",
    • "last_seen_at": "2019-08-24T14:15:22Z",
    • "data": {
      • "rate": 1,
      • "baseline_rate": 0.02,
      • "total": 60
      }
    }
]

List active alerts

Returns the account's currently active alerts, sorted by severity (critical first) and then by today's affected volume. Alerts are generated by the LeadConduit alert detection engine (recipient failure or skip spikes, source rejection spikes, flows that stopped posting, category rejections such as duplicates or TrustedForm failures, and new sources). Only active alerts are returned; resolved alert history is not available through this endpoint. Responses carry entity IDs, names, and aggregate counts only — never lead data.

SecurityAPIKey
Responses
200

OK

401

Authentication failed

get/alerts
Request samples 
Response samples 
application/json
[
  • {
    • "key": "recipient-failure:42:5e8b6f...|5f1c...|leadconduit-custom.outbound.form",
    • "type": "recipient-failure",
    • "kind": "failure",
    • "severity": "critical",
    • "message": "100% of submissions to CRM One in Web Leads are failing",
    • "detail": "60 of 60 submissions today · typical last 7 days: 2% · most common reason: Timeout",
    • "flow_id": { },
    • "flow_name": "Web Leads",
    • "entity_id": "5e8b6f91f0d12766e2bfee51",
    • "entity_name": "CRM One",
    • "recipient_id": "string",
    • "outcome": "skip",
    • "time_zone": "America/Chicago",
    • "first_seen_at": "2019-08-24T14:15:22Z",
    • "last_seen_at": "2019-08-24T14:15:22Z",
    • "data": {
      • "rate": 1,
      • "baseline_rate": 0.02,
      • "total": 60
      }
    }
]