Glossary

Explore Meshline

Products Pricing Blog Support Log In

Ready to map the first workflow?

Book a Demo

Glossary / Evaluation and implementation guide

Poison Message Handling

Poison message handling is the policy for events that can never be processed successfully — a malformed payload, a missing required field, an encoding error.

Unlike a transient failure, retrying a poison message fails forever, and in sequential queues it blocks every event behind it.

Handling requires three decisions: detect the poison pattern (usually after a fixed retry count), isolate the message (quarantine it in a holding area or discard it), and alert someone.

Without this policy, one bad payload from a form vendor can silently stall lead routing for hours.

A practical example

Example: a form vendor pushes an event with an unexpected null in the email field.

After three failed retries, the platform quarantines the message, moves subsequent events through, and notifies the ops channel with the payload attached.

What to evaluate before investing

  • Ask whether the platform quarantines unprocessable events automatically or lets them retry indefinitely.
  • Confirm quarantine includes the full payload and error detail so you can fix the source, not just the symptom.
  • Check whether quarantined events can be corrected and reprocessed, or whether isolation means permanent loss.

Limitations and tradeoffs

Quarantining keeps the pipeline moving but hides a data gap: the quarantined event's information never reaches downstream systems until someone intervenes. Set alerting and review cadence, or quarantines become silent graveyards.

Plan your next step with MeshLine

Connect this decision to your automation, organic marketing and customer lifecycle management. In a MeshLine demo, discuss your existing tools, the scope you need and how to measure the result.