Shopify API library: catch CookieNotFound on OAuth callback and restart OAuth

TL;DR

Wrap shopify.auth.callback in a try/catch, catch the cookie error specifically, and redirect the user back through shopify.auth.begin to restart OAuth.

Steps

1. When the Shopify OAuth callback throws CookieNotFound, dont treat it as fatal. Wrap shopify.auth.callback in a try/catch, catch the cookie error specifically, and redirect the user back through shopify.auth.begin to restart OAuth. That handles the case where the callback arrives without its cookie and lets the flow recover on its own.

When to use

You are seeing this: When the Shopify OAuth callback throws CookieNotFound, dont treat it as fatal. Use this skill when you run into "Shopify API library: catch CookieNotFound on OAuth callback and restart OAuth".

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

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

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

Source: GitHub issue Shopify/shopify-api-js#686 (closed, 42 comments): the OAuth callback kept throwing Could not find an OAuth cookie for the shop URL. A Shopify maintainer's recommended fix: wrap the shopify.auth.callback call in a try/catch and redirect back into the OAuth flow when the CookieNotFound error is thrown, since the cookie can legitimately be missing on a fresh or retried callback.

Verified resolution: When the Shopify OAuth callback throws CookieNotFound, dont treat it as fatal. Wrap shopify.auth.callback in a try/catch, catch the cookie error specifically, and redirect the user back through shopify.auth.begin to restart OAuth. That handles the case where the callback arrives without its cookie and lets the flow recover on its own.

Source URL: https://github.com/Shopify/shopify-api-js/issues/686