Webhooks - Payload - System Alert - Plusvibe.ai API Documentation

Below is a sample payload for the "System Alert" (SYSTEM_ALERT) webhook and its corresponding field descriptions.

This event is triggered when something in the workspace needs attention — an email account disconnecting, forwarded replies bouncing, billing problems and more. When setting up the webhook you choose which alerts to receive; you only get the alerts you selected.

Field	Description
webhook_id	Unique identifier for this webhook event.
webhook_name	Name of the webhook.
workspace_name	Name of the workspace.
webhook_event	Type of event that triggered the webhook (`SYSTEM_ALERT`).
alert	Which alert fired (see the alert list below).
alert_type	The severity label you assigned to this alert when configuring the webhook (`NORMAL`, `ALERT` or `URGENT`).
data	Alert-specific details; the structure varies per alert — see the samples below. Arrays inside `data` are capped at 10 items; a count field alongside (e.g. `total_count`) always reflects the full number.

{
"webhook_id": "507f1f77bcf86cd799439011",
"webhook_name": "Account health alerts",
"workspace_name": "Acme Workspace",
"webhook_event": "SYSTEM_ALERT",
"alert": "EMAIL_ACCOUNT_DISCONNECTED",
"alert_type": "URGENT",
"data": {
"total_count": 3,
"accounts": [
{ "email": "sales@acme.com", "provider": "GOOGLE_WORKSPACE", "status": "DISCONNECTED", "warmup_status": "PAUSED", "reason": "invalid_grant", "error_time": "2026-07-26T10:15:00.000Z" }
]
}
}

Alert types and their `data`

EMAIL_ACCOUNT_DISCONNECTED — one or more sending accounts went into an error state (see the full sample above):

{
"total_count": 3,
"accounts": [
{ "email": "sales@acme.com", "provider": "GOOGLE_WORKSPACE", "status": "DISCONNECTED", "warmup_status": "PAUSED", "reason": "invalid_grant", "error_time": "2026-07-26T10:15:00.000Z" }
]
}

EMAIL_ACCOUNT_FORWARDING_BOUNCED — a reply forwarded from a sending account bounced:

{
"total_count": 2,
"accounts": [
{ "email": "sales@acme.com", "forwarded_to": "inbox@acme.com" }
]
}

INTEGRATION_GSHEET_SYNC_FAILED — a Google Sheet sync failed (sync_type is LEAD_IMPORT or BLOCKLIST_IMPORT; the campaign fields are present for lead imports only):

{
"sync_type": "LEAD_IMPORT",
"campaign_id": "507f1f77bcf86cd799439015",
"campaign_name": "Q3 Outreach",
"gsheet_url": "https://docs.google.com/spreadsheets/d/1AbCdEfGhIjKlMnOpQrStUvWxYz",
"error": "Range not found",
"error_count": 3
}

BILLING_PAYMENT_FAILED — a subscription charge failed:

{
"stripe_event": "charge.failed",
"stripe_customer_id": "cus_SampleCustomer01",
"payment_method_type": "us_bank_account",
"amount_due": 99.00,
"currency": "usd",
"invoice_id": "in_SampleInvoice01"
}

BILLING_SUBSCRIPTION_EXPIRED — the workspace's PlusVibe subscription expired (subscription_type: TRIAL or PAID):

{ "subscription_type": "TRIAL" }

BILLING_DFY_SUBSCRIPTION_EXPIRED — a Done-For-You email subscription expired:

{
"service": "DFY",
"affected_emails_count": 12,
"affected_emails": ["a@acme.com", "b@acme.com", "c@acme.com"]
}

BILLING_DFY_DOMAIN_CANCELLED — a DFY domain subscription was cancelled:

{
"service": "DFY_DOMAIN",
"stripe_sub_id": "sub_SampleDomainSub01",
"user_cancelled": true,
"domains": ["acme.com", "acme.io"]
}

BILLING_DFY_EMAIL_EXPIRED — a DFY email subscription ended:

{ "service": "DFY_EMAIL", "stripe_sub_id": "sub_SampleEmailSub01" }

BILLING_DFY_PAYMENT_FAILING — a DFY subscription payment is failing and the service will expire if unresolved:

{
"service": "DFY_EMAIL",
"stripe_sub_status": "past_due",
"valid_till": "2026-08-02T10:15:00.000Z",
"items_count": 5,
"items": ["a@acme.com", "b@acme.com"]
}

BILLING_PLACEMENT_SUBSCRIPTION_EXPIRED — an email placement test subscription expired:

{
"service": "EMAIL_PLACEMENT",
"plan": "SCALE",
"stripe_sub_id": "sub_SamplePlacementSub01",
"status": "canceled"
}

INTEGRATION_DISCONNECTED — a connected integration lost authorization:

{
"integration": "HUBSPOT",
"integration_name": "HubSpot",
"reason": "Refresh token expired or revoked"
}

WEBHOOK_DISABLED — another webhook in the workspace was automatically disabled after repeated failed deliveries (the disabled webhook itself is never notified):

{
"disabled_webhook_id": "507f1f77bcf86cd799439021",
"disabled_webhook_name": "My CRM webhook",
"reason": "MAX_FAILURES_REACHED",
"consecutive_failures": 50,
"last_error": "connect ETIMEDOUT",
"disabled_at": "2026-07-26T10:15:00.000Z"
}

CAMPAIGN_AUTO_PAUSED — a campaign was automatically paused because its bounce rate exceeded the configured limit:

{
"campaign_id": "507f1f77bcf86cd799439015",
"campaign_name": "Q3 Outreach",
"reason": "BOUNCE_RATE_EXCEEDED",
"bounce_rate": 7,
"bounce_rate_limit": 5,
"bounced_count": 12,
"sent_count": 160
}

From the web app's webhook settings you can send sample payloads — for SYSTEM_ALERT this sends one sample delivery per alert type so you can test your handler end to end.

Webhooks - Payload - System Alert

Alert types and their data#

Alert types and their `data`