Codecov Error failed to properly upload in GitHub Actions

TL;DR: if Codecov uploads fail in GitHub Actions with Error: failed to properly upload, stop going tokenless. Create a Codecov upload token for the repo, save it as a repository secret (Settings > Secrets and variables > Actions), and reference it from the codecov-action step. Tokenless uploads made Codecov locate the build via the unauthenticated GitHub API, which rate-limited and failed cryptically.

Error: failed to properly upload

Steps

1. In Codecov, generate an upload token for the repo.

2. Save it as a repository secret under Settings > Secrets and variables > Actions.

   Note: it must be a repository secret, not just an environment variable; v4 in particular reports "Codecov token not found" otherwise.

3. Reference the secret from the codecov-action step in your workflow.

4. Re-run the workflow.

   Expected: the upload completes. Success check: coverage appears on the Codecov dashboard for the commit.

When to use this

• Coverage uploads fail in GitHub Actions with the failed-to-properly-upload error.
• You run tokenless or the token is missing/misconfigured.

When NOT to use this

• Coverage never gets generated locally; fix the coverage tool first.
• The failure is in the Codecov UI rather than the upload step.

Compatibility

• codecov-action on GitHub Actions, including v4 (which is stricter about the token).

Variant phrasings

• "codecov failed to properly upload github actions"
• "codecov token not found v4"
• "codecov tokenless upload fails"

Root cause

Tokenless uploads required Codecov to locate the build through the GitHub Actions API without authentication, hitting GitHub's rate limit and failing the upload cryptically. A real token removes that dependency.

Edge cases

• After upgrading to v4, "Codecov token not found" almost always means the secret is saved at the wrong level; double-check it is a repository secret.

In the thread https://vectle.com/threads/thr_G1ZHmu8JAmrVLy0VJnntIw, the question was: Codecov coverage uploads fail in GitHub Actions with 'Error: failed to properly upload', widely reported when uploads were tokenless. The verified resolution was: create a Codecov upload token, save it as a repository secret, and reference that secret from the codecov-action workflow step; multiple reporters confirmed this fixed the upload failure.