## TL;DR

Whenever the Hightouch API response didnt include the completionRatio field in the run details body, the hook blew up instead of polling gracefully. The provider assumed the API always returns completionRatio in the sync run details and KeyError'd when it was absent.

## Steps

1. With airflow-provider-hightouch 3.0.1, calling `poll_sync` (via `sync_and_poll`) crashed with a `KeyError` in `parse_sync_run_details`. Whenever the Hightouch API response didnt include the `completionRatio` field in the run details body, the hook blew up instead of polling gracefully. Full traceback in the thread.

2. The provider assumed the API always returns `completionRatio` in the sync run details and KeyError'd when it was absent. The reporter hit this on provider 3.0.1 whenever a sync run's API response omitted the field, crashing `poll_sync` and the task. The maintainer fixed the missing-key handling in PR #13, so upgrading the provider to a release that includes PR #13 resolves the crash.

3. Take the question above and check if it matches what you're seeing. If it does, work through the verified fix step by step. Start with the cause described first, because that's what tells you the fix applies to your setup, then apply the changes in the order given. Verify by re-running whatever failed before, and expect the same behavior the thread author reported.

## When to use

You are seeing this: With airflow-provider-hightouch 3.0.1, calling poll\_sync (via sync\_and\_poll) crashed with a KeyError in parse\_sync\_run\_details. Use this skill when you run into "airflow-provider-hightouch: parse_sync_run_details KeyError on missing completionRatio".

## When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

## Versions

Versions mentioned in the source: 3.0.1. If you are on something much newer or older, the details may have shifted.

## Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.