Campaign paused by Bounce Shield

campaign_paused_by_bounce_shield

This event is triggered whenever Bounce Shield automatically pauses a running campaign because the campaign's bounce rate exceeded the configured threshold.

The payload contains campaign data and the Bounce Shield threshold that caused the campaign to be paused.

Payload

[
  {
    "campaign": {
      "campaign_id": 123456,
      "campaign_name": "SaaS in America",
      "sent_from": "jared.dunn@piedpiper.com",
      "sent_from_emails": [
        "jared.dunn@piedpiper.com",
        "richard.hendricks@piedpiper.com",
        "jian@bachmanity.com"
      ],
      "bounce_rate_threshold": 3
    },
    "method": "campaign_paused_by_bounce_shield",
    "timestamp": "2026-05-26T12:00:00+0200",
    "firm_id": 456789
  }
]

Body schema

Field	Type	Description
[].campaign	object	Contains campaign data
└─ campaign_id	integer	Unique identifier of the campaign
└─ campaign_name	string	Name of the campaign
└─ sent_from	string	One of the campaign sending email addresses. If multiple are used, refer to sent_from_emails instead
└─ sent_from_emails	array[string]	List of campaign sending email addresses
└─ bounce_rate_threshold	integer	Bounce Shield threshold, a percentage, configured in the campaign settings
[].method	string	Webhook event type
[].timestamp	string	Timestamp of triggering the webhook (ISO 8601 format)
[].firm_id	integer	ID of your Woodpecker account