Troubleshooting¶

Solutions to common issues with Smailander.

Email Delivery Issues¶

Not Receiving Emails¶

Symptoms: Honeypots not capturing emails

Possible Causes: 1. DNS/MX records misconfigured 2. Honeypot is inactive 3. Domain not verified 4. Firewall blocking email servers

Solutions:

1. Check DNS Configuration¶

# Check MX records
dig mx yourdomain.com

# Expected output should include Smailander's mail servers

2. Verify Honeypot Status¶

Go to Dashboard → Honeypots
Check honeypot status is "Active"
Verify email address is correct

3. Verify Domain Status¶

Go to Settings → Domains
Check domain verification status
Ensure DNS records are properly configured

4. Test Email Delivery¶

# Send test email to honeypot
echo "Test" | mail -s "Test" honeypot@yourdomain.com

Emails Not Forwarding¶

Symptoms: Emails captured but webhook notifications not sent

Possible Causes: 1. Webhook URL misconfigured 2. Webhook endpoint not responding 3. Network connectivity issues

Solutions:

1. Verify Webhook Configuration¶

Go to Settings → Webhooks
Check webhook URL is correct
Verify webhook is enabled

2. Test Webhook Endpoint¶

# Test endpoint manually
curl -X POST https://your-server.com/webhook \
  -H "Content-Type: application/json" \
  -d '{"test": true}'

3. Check Webhook Logs¶

Go to Dashboard → Webhooks
View webhook delivery logs
Check for failed deliveries

Dashboard Issues¶

Dashboard Not Loading¶

Symptoms: Dashboard page stuck or showing errors

Solutions:

1. Clear Browser Cache¶

// Clear cache and reload
location.reload(true);

2. Check Browser Console¶

Open browser DevTools and check for errors

3. Try Different Browser¶

Chrome
Firefox
Edge
Safari

Data Not Displaying¶

Symptoms: Dashboard shows empty tables or missing data

Possible Causes: 1. No emails captured yet 2. Filter settings too restrictive 3. Data loading error

Solutions:

1. Check Filters¶

Clear all filters
Reset to default view
Check date range

2. Verify API Connection¶

# Test API connection
curl -X GET https://api.smailander.com/v1/emails \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Check Browser Network Tab¶

Open DevTools → Network
Look for failed requests
Check response codes

API Issues¶

API Authentication Failed¶

Symptoms: 401 Unauthorized errors

Possible Causes: 1. Invalid API key 2. Expired API key 3. Missing API key

Solutions:

1. Verify API Key¶

# Check API key format
# Should be: sk_live_xxxxxxxxxxxxxx or sk_test_xxxxxxxxxxxxxx

2. Regenerate API Key¶

Go to Settings → API Keys
Regenerate the key
Update your application

3. Check API Key Permissions¶

Verify key has required permissions
Update permissions if needed

Rate Limit Errors¶

Symptoms: 429 Too Many Requests errors

Solutions:

1. Implement Exponential Backoff¶

async function makeRequestWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options);

      if (response.status === 429) {
        const retryAfter = response.headers.get('Retry-After');
        await new Promise(resolve => 
          setTimeout(resolve, (retryAfter || 60) * 1000)
        );
        continue;
      }

      return response;
    } catch (error) {
      if (i === maxRetries - 1) throw error;
      await new Promise(resolve => 
        setTimeout(resolve, Math.pow(2, i) * 1000)
      );
    }
  }
}

2. Check Plan Limits¶

Go to Settings → Billing
Check current plan limits
Upgrade if needed

Webhook Delivery Failures¶

Symptoms: Webhooks not delivering to your endpoint

Possible Causes: 1. Endpoint not reachable 2. Endpoint returning errors 3. Signature verification failed

Solutions:

1. Test Webhook Endpoint¶

# Test endpoint with curl
curl -X POST https://your-server.com/webhook \
  -H "Content-Type: application/json" \
  -d '{"test": true}'

2. Check Webhook Logs¶

Go to Dashboard → Webhooks
View webhook delivery logs
Check for errors

3. Verify Signature¶

const crypto = require('crypto');

function verifyWebhookSignature(payload, signature, secret) {
  const hmac = crypto.createHmac('sha256', secret);
  hmac.update(payload);
  const expectedSignature = hmac.digest('base64');

  return signature === expectedSignature;
}

Performance Issues¶

Slow Dashboard¶

Symptoms: Dashboard pages load slowly

Solutions:

1. Reduce Data Load¶

Apply filters to reduce data
Lower items per page
Use date ranges

2. Clear Cache¶

// Clear application cache
localStorage.clear();
sessionStorage.clear();

3. Check Network Connection¶

Run speed test
Check for network issues
Try different network

Slow API Responses¶

Symptoms: API calls taking too long

Solutions:

1. Use Pagination¶

# Use smaller page sizes
GET /v1/emails?limit=25&page=1

2. Select Specific Fields¶

# Only request needed fields
GET /v1/emails?fields=id,subject,threat_score

3. Filter Early¶

# Apply filters to reduce data
GET /v1/emails?threat_score=gt:50&date_range=2026-03-01:2026-03-12

Account Issues¶

Can't Log In¶

Symptoms: Login page not working

Solutions:

1. Clear Cookies¶

Go to browser settings
Clear cookies for smailander.com
Try logging in again

2. Check Email Inbox¶

Check spam folder
Verify magic link email arrived
Wait a few minutes and retry

3. Try Different Browser¶

Test in Chrome, Firefox, Safari
Check if issue is browser-specific

Account Locked¶

Symptoms: Account shows as locked or suspended

Solutions:

1. Contact Support¶

Email: support@smailander.com

Include: - Your account email - Reason for lock (if known) - Last actions taken

2. Verify Email Ownership¶

Reply to confirmation email
Verify domain ownership
Provide additional verification

Getting Help¶

Self-Service Resources¶

FAQ - Frequently asked questions
API Documentation - API reference
Getting Started - Setup guides

Contact Support¶

Email: support@smailander.com

Response Time: - Free: 48-72 hours - Pro: 24-48 hours - Enterprise: 4-8 hours

When Contacting Support¶

Include: 1. Your account email 2. Detailed description of issue 3. Steps to reproduce 4. Screenshots if applicable 5. Error messages (full text) 6. Browser and version 7. Operating system and version

Debug Mode¶

Enable debug mode for more information:

// Enable debug mode in browser console
localStorage.setItem('smailander_debug', 'true');
location.reload();

Debug information will appear in browser console.

System Status¶

Check current system status:

Status Page: https://status.smailander.com

Next Steps¶

FAQ - Common questions
Contact - Contact us
Getting Started - Setup guides