Supabase Error Codes

Supabase Error Codes: Complete reference of Supabase error codes covering the Auth API… Searchable index with fixes, code examples, and official sources.

Supabase errors arrive from three different layers, and the code format tells you which: PGRST1xx/2xx/3xx codes come from PostgREST (the auto REST API), snake_case codes like invalid_credentials come from GoTrue (auth), and CamelCase codes like NoSuchBucket come from Storage. A PGRST code usually means a schema-cache or query-shape problem, while auth codes mean session or credential handling — the pages below separate all three.

15 error codes Supabase Last verified 2026-08-19

All 15 error codes

invalid_credentials Invalid Credentials Login credentials or grant type not recognized. PGRST116 Multiple or Zero Rows for a Singular Request More than 1 or no items were returned when requesting a singular response. PGRST301 Invalid or Undecodable JWT Provided JWT couldn't be decoded or it is invalid. email_not_confirmed Email Not Confirmed Email not confirmed. user_already_exists User Already Exists User already registered. PGRST205 Table Not Found in Schema Cache Caused when the table specified in the URI is not found. token_expired Token Expired JWT expired. EntityTooLarge Upload Exceeds Maximum Object Size Your proposed upload exceeds the maximum allowed object size. NoSuchBucket Storage Bucket Not Found The specified bucket does not exist. refresh_token_not_found Refresh Token Not Found Session containing the refresh token not found. over_email_send_rate_limit Over Email Send Rate Limit Too many emails have been sent to this email address. Ask the user to wait a while before trying again. otp_expired Otp Expired OTP code for this sign-in has expired. Ask the user to sign in again. weak_password Weak Password Password should be at least 8 characters. user_not_found User Not Found User not found. PGRST203 Ambiguous Function Overload Caused by requesting overloaded functions with the same argument names but different types, or by using a...

Official Sources