Two levels of failure
Integration problems appear at two levels:
Level | Meaning |
Failed job | The entire integration run failed (for example, connection or validation error) |
Failed syncs (failed records) | The job succeeded, but individual records could not be processed |
The integration health status bar surfaces failed outbound jobs at a glance.
Review a failed job
Log in to your Aragorn AI account.
Open Integrations.
Check the health status bar for integration failures
Select the affected integration.
Open job history (see view job history).
Find the failed job and read the failure reason.
Review failed records (failed syncs)
When a job completes but some records fail:
Open the integration job details.
Go to Failed syncs
.
Review which records failed and why they could not be processed.
Example: A mapping rule marks middle_name as required, but one employee has no middle name—Aragorn AI fails validation before contacting the vendor.
Common fixes
Symptom | What to check |
Job failed before vendor contact | Connection credentials, mapping validation, required fields |
Record-level failures | Nullable/required settings, missing project data, eligibility filters |
Wrong data sent | Project final dataset, then integration mapping |
After fixing
Update mapping, eligibility, or connection as needed.
Run in test mode to verify.
Run manually or wait for the next scheduled run.