Skip to content

Commit 7e9355d

Browse files
Added a few more common errors
1 parent 0daf6ee commit 7e9355d

File tree

1 file changed

+35
-1
lines changed

1 file changed

+35
-1
lines changed

src/content/docs/get-started/guides/error-codes.mdx

Lines changed: 35 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
page_id: 46149cb3-fa96-46a2-bd94-0ba4aacae527
3-
title: Common error codes
3+
title: Common errors and codes
44
sidebar:
55
order: 5
66
relatedArticles:
@@ -11,6 +11,40 @@ Depending on the complexity of your authentication setup, you or your users may
1111

1212
Here are some common error codes and troubleshooting steps.
1313

14+
## Sorry we don't see way to authenticate you
15+
16+
This error message typically appears when there's an issue with your authentication configuration or token handling. A few common causes include:
17+
- Expired or invalid tokens
18+
- Misconfigured authentication settings
19+
- Session management issues
20+
- Incorrect callback URLs
21+
22+
## State not found
23+
24+
The `State not found` error typically occurs when there's a mismatch between your environment variables and the domain you're using during authentication. There may be a trailing space or incorrect syntax.
25+
26+
## Verification code not received (email)
27+
28+
Verification codes are sent almost immediately when triggered. If a code is not received, it might be because:
29+
30+
- Junk/spam folders​ - Email providers and devices may treat OTPs from unknown providers like Kinde as spam. Check your own spam folder, or ask your IT team if emails from Kinde are quarantined by firewalls or other IT defence systems.
31+
- Gmail delays​ - Google Workspace addresses can experience ~4 minute delays due to pre-delivery scanning
32+
- Microsoft Defender filters​ - Aggressive anti-spam filters sometimes quarantine verification emails for Outlook/Hotmail users
33+
34+
If none of the above help troubleshoot the issue, contact Kinde support.
35+
36+
## Verification code not received (mobile device)
37+
38+
Verification codes are sent almost immediately when triggered. If a code is not received, it might be because:
39+
40+
- Network connectivity problems or poor signal strength
41+
- Carrier-level spam filtering blocking OTP messages
42+
- SMS delivery delays during peak usage times
43+
- Full storage preventing new messages from being received
44+
- Phone numbers in certain countries do sometimes experience issues. Contact us if you think this might be the case.
45+
46+
We recommend using [Twilio](/authenticate/authentication-methods/phone-authentication/), a third-party SMS provider instead of Kinde's default service. This makes troubleshooting issues and accessing logs much easier.
47+
1448
## Error code 578
1549

1650
Description

0 commit comments

Comments
 (0)