I received an alert — what now?

What to do when you receive an error notification from HighCohesion.

Step 1: Open the event

Most alerts include a direct link to the failed event in the Control Panel. Click it to open the event detail view. If there's no link, go to the Control Panel, find the relevant stream, and filter by Failed status to locate it.

Step 2: Read the error

HighCohesion errors fall into a few categories. Understanding the type helps you decide what to do next:

Error type

What it means

Typical action

Missing required field

The destination expected a field that wasn't present in the payload

Check source data; may need a mapping fix

Invalid value

A field contained a value the destination couldn't accept (e.g. wrong format, out of range)

Check source data or contact HC for a mapping fix

Destination unavailable

The destination system returned a timeout or server error

Wait and retry — often transient

Duplicate detected

The event was already processed

Usually safe to ignore; confirm in destination

Business rule violation

The destination rejected the event based on its own logic (e.g. order already exists)

Investigate in the destination system

Step 3: Decide what to do

  • Transient error (destination unavailable, timeout): Click Resend — no edits needed

  • Data error (missing field, invalid value): Fix and resend, or contact HC if it's a mapping issue

  • Investigate further: Check whether related events in the same stream are also failing

Step 4: Check for related failures

If one event failed, others may have too. Filter the stream by Failed status and the same time window to see if it's an isolated incident or a wider problem.

If you're seeing many failures, request a bulk resend after the root cause is resolved.

Related