SMTP mailbox sending error

smtp_mailbox_send_error

This event is triggered when an SMTP mailbox encounters an error during campaign sending that temporarily pauses sending from that mailbox. The payload identifies the mailbox and campaign and includes the error type and message.

Payload

[
  {
    "mailbox": {
      "id": 123456,
      "email": "jared.dunn@piedpiper.com"
    },
    "campaign": {
      "id": 6789000,
      "name": "SaaS in Europe"
    },
    "error": {
      "type": "Quota exceeded",
      "msg": "You've reached your email provider's sending limit"
    },
    "method": "smtp_mailbox_send_error",
    "timestamp": "2026-10-26T10:30:34+0100",
    "firm_id": 456789
  }
]

Body schema

Field	Type	Description
[].mailbox	object	Mailbox affected by the sending error
└─ id	integer	Unique identifier of the mailbox
└─ email	string	Email address of the mailbox
[].campaign	object	Campaign affected by the sending error
└─ id	integer	Unique identifier of the campaign
└─ name	string	Name of the campaign
[].error	object	Details of the SMTP sending error
└─ type	string	Error type from email sending statistics, or UNKNOWN_SMTP_ERROR if unavailable
└─ msg	string	Detailed error message, or Email sending failed due to an unrecognized SMTP error. if unavailable
[].method	string	Webhook event type: smtp_mailbox_send_error
[].timestamp	string	Timestamp of triggering the webhook (ISO 8601 format)
[].firm_id	integer	ID of your Woodpecker account