Troubleshooting

Most common errors, ordered by frequency.

`Missing GUMROAD_TOKEN env var`

Set the env var before running:

export GUMROAD_TOKEN=...

Get the token from Gumroad → Settings → Advanced → Applications → Create access token.

`HTTP 401` from the Gumroad API

The token is wrong, expired, or revoked. Regenerate it and re-export.

`Product 'X' not found in your account`

The permalink in your config doesn't match any product on your Gumroad account. Confirm the custom permalink on the Gumroad product page (Settings → URL).

All entry-point HEAD probes fail with HTTP 404

Your deployed site is missing those files. Re-run your deploy script. If using meerkat-llc-site/deploy.sh, confirm the rsync filter rules don't exclude them (this is the silent-failure mode the spec documents).

`GumRoad.md spec missing section: X`

Either you removed the section from the spec or someone edited a heading. Restore the section, OR update the runner's expected list to match the new naming.

n8n run hangs

Check the Read GumRoad.md node first — if gumroad_md_url points at a file:// path that n8n can't read (sandbox / Docker permissions), the request times out. Switch to an HTTPS URL or move the spec to a path n8n can reach.

Slack messages don't post

Bot not invited to the channel — /invite @your-bot
Wrong channel ID in SLACK_QA_CHANNEL env — must be the ID like C0123456, not the channel name
Missing chat:write scope — re-install the Slack app

Notion log row not created

Integration not shared with the QA log database
Property names mismatch — the database needs Product, Permalink, Spec source, Result, Pass count, Fail count, Ran At, Detail

"Meerkat LLC" and the Professor Meerkat mascot are marks of Meerkat LLC.

Troubleshooting

Missing GUMROAD_TOKEN env var

HTTP 401 from the Gumroad API

Product 'X' not found in your account