Webhook events

Block list

Emails and domains added to or removed from the account block list.

Emails and domains added to or removed from the account block list.

These pages are payload reference. For setup, verification, and retries, follow Webhook integration.

Examples use placeholder UUIDs. Live deliveries use real ids from your account.

blocklist.entry_added

An email or domain was added to the account block list. A hard bounce that also writes the block list emits this event and bounce.detected.

Email

{
  "id": "00000000-0000-4000-8000-0000000000aa",
  "type": "blocklist.entry_added",
  "occurred_at": "2026-06-25T12:00:00.000Z",
  "data": {
    "campaign_id": "22222222-2222-4222-8222-222222222222",
    "campaign_name": "Example campaign",
    "lead_id": "00000000-0000-4000-8000-000000000001",
    "email": "lead@example.com",
    "mailbox_id": "00000000-0000-4000-8000-000000000004",
    "mailbox_email": "sender@example.com",
    "first_name": "Casey",
    "last_name": "Reed",
    "full_name": "Casey Reed",
    "company_name": "Wasatch Corridor",
    "title": "VP Sales",
    "website": "https://wasatch.example",
    "linkedin_url": "https://linkedin.com/in/casey-reed",
    "custom_fields": {
      "title": "VP Sales",
      "region": "west"
    },
    "enrollment_id": "00000000-0000-4000-8000-000000000002",
    "value": "lead@example.com",
    "type": "email",
    "reason": "unsubscribed",
    "source": "reply_opt_out"
  }
}

Domain

{
  "id": "00000000-0000-4000-8000-0000000000aa",
  "type": "blocklist.entry_added",
  "occurred_at": "2026-06-25T12:00:00.000Z",
  "data": {
    "value": "example.com",
    "type": "domain",
    "reason": "manual",
    "source": "api"
  }
}

blocklist.entry_removed

An email or domain was removed from the account block list.

Email

{
  "id": "00000000-0000-4000-8000-0000000000aa",
  "type": "blocklist.entry_removed",
  "occurred_at": "2026-06-25T12:00:00.000Z",
  "data": {
    "campaign_id": "22222222-2222-4222-8222-222222222222",
    "campaign_name": "Example campaign",
    "lead_id": "00000000-0000-4000-8000-000000000001",
    "email": "lead@example.com",
    "mailbox_id": "00000000-0000-4000-8000-000000000004",
    "mailbox_email": "sender@example.com",
    "first_name": "Casey",
    "last_name": "Reed",
    "full_name": "Casey Reed",
    "company_name": "Wasatch Corridor",
    "title": "VP Sales",
    "website": "https://wasatch.example",
    "linkedin_url": "https://linkedin.com/in/casey-reed",
    "custom_fields": {
      "title": "VP Sales",
      "region": "west"
    },
    "enrollment_id": "00000000-0000-4000-8000-000000000002",
    "value": "lead@example.com",
    "type": "email",
    "reason": "manual",
    "source": "inbox"
  }
}

Domain

{
  "id": "00000000-0000-4000-8000-0000000000aa",
  "type": "blocklist.entry_removed",
  "occurred_at": "2026-06-25T12:00:00.000Z",
  "data": {
    "value": "example.com",
    "type": "domain",
    "reason": "manual",
    "source": "inbox"
  }
}