Skip to main content

key_unknown — we don’t recognize that key

What happened

The widget sent an X-Embed-Key header, but the SHA-256 hash of that value doesn’t match any row in our database. Either the key was mistyped, truncated on paste, or belongs to a different environment.

Common causes

  • Character-by-character mismatch vs. the key on Console → Settings → Embed Code. pk_live_ keys have no spaces, hyphens, or line breaks in the middle.
  • Copied from a chat app that replaced quotes with smart quotes, or added a trailing newline.
  • You rotated the key recently and the old value is on the live page.

How to grab the right key

  1. Compare the value on your page to the one on Console → Settings → Embed Code, character by character.
  2. If you rotated your key recently, the old value is dead — grab the new one from the console and re-paste.
  3. Still stuck? Book 15 minutes with Mark — we can look up your key’s hash on our side.

Related