Monitor carrier account health
Carriyo continuously tracks how each carrier account is performing, whether shipments are being assigned to it, whether the carrier is returning status updates, and whether any bookings have outstanding errors. The Health indicator on the carrier accounts list page is the at-a-glance answer; the account's Status tab is where you go for detail when something looks off.
Before you start
- You need the admin or account-manager role.
- This procedure is read-only. Nothing here changes account configuration. To pause or fix an account, see Manage carrier account settings or Manage carrier account assignments.
1. Scan the Health column on the accounts list
Navigate to Settings → Carrier Accounts in the Carriyo Dashboard. The Health column shows each account's current status. Scan the column to find anything other than Healthy or Idle. Those are the accounts that need attention.
2. Open the Status tab on an account that needs attention
Click the account row, then open the Status tab. The Activity Tracking section summarises shipment status-update errors in the last 48 hours and the total number of shipments currently in error for that account. The Activity Information section lists the latest relevant events, useful for spotting whether the trouble is recent or accumulated.
Health status reference
| Status | Meaning | Typical action |
|---|---|---|
| Healthy | Shipments are assigned to the account, open shipments have received status updates within the last 48 hours, and no shipments have outstanding errors. | None. |
| Idle | No shipment has been assigned to the account since it was created. | Confirm the account is meant to be in use. If yes, check carrier-account assignments and your shipping rules to find out why nothing is routing to it. |
| Inactive | The carrier account is deactivated. No shipments can be assigned until it's reactivated. | Reactivate via the header toggle on the account detail page if the pause was unintentional. |
| Trouble | One or more shipments have outstanding errors, or open shipments haven't received status updates in the last 48 hours, or both. | Open the Status tab, identify the affected shipments, and resolve them via Resolve shipment errors. Persistent trouble usually points at credential expiry, a carrier-side outage, or a misconfigured callback. |
Common causes of Trouble status
- Expired or rotated credentials: most common for carriers where API keys have a fixed lifetime. The shipper account number is fine; the API key or secret has been rotated by the carrier. Re-enter the credentials and the account goes Healthy on the next booking.
- Carrier-side webhook failure: for manual-callback carriers like DHL Express, the callback URL may have been removed on the carrier's side. Confirm with your carrier rep that the webhook is still registered.
- A backlog of unresolved booking errors: one or two bad shipments can push the account to Trouble. Resolve the underlying shipments and the status recovers automatically.