​

Common Errors & Solutions

​

🔐 Authentication Errors

​

401 Unauthorized

• Check your API key is correct
• Ensure the key hasn’t expired
• Verify you’re using the right environment (dev/prod)

# Check your API key
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.posthoot.com/api/v1/users/me

​

403 Forbidden

• Verify your account has the required permissions
• Check if your subscription plan includes this feature
• Contact support if you believe this is an error

​

⚡ Rate Limiting Errors

​

429 Too Many Requests

• Check the X-RateLimit-Remaining header
• Wait for the reset time shown in X-RateLimit-Reset
• Implement exponential backoff in your code

// Example: Handle rate limiting
const response = await fetch('/api/v1/email/send', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});

if (response.status === 429) {
  const resetTime = response.headers.get('X-RateLimit-Reset');
  const waitTime = (resetTime * 1000) - Date.now();
  await new Promise(resolve => setTimeout(resolve, waitTime));
}

​

📧 Email Sending Errors

​

400 Bad Request - Invalid SMTP Configuration

• Verify SMTP host, port, username, password
• Check if your SMTP provider requires SSL/TLS
• Test SMTP connection separately

​

500 Internal Server Error - Email Delivery Failed

• Check recipient email address is valid
• Verify your SMTP provider is working
• Review email content for spam triggers
• Check your sending reputation

​

📊 Analytics Errors

​

404 Not Found - Analytics Data Unavailable

• Ensure the campaign/email ID is correct
• Check if enough time has passed for data collection
• Verify the date range is valid

​

422 Unprocessable Entity - Invalid Date Range

• Use ISO 8601 format: 2024-01-01T00:00:00Z
• Ensure start date is before end date
• Check date range isn’t too large (max 90 days)

​

🔧 General API Errors

​

500 Internal Server Error

• Check our status page
• Retry the request (implement retry logic)
• Contact support if persistent

​

502 Bad Gateway

• Wait a few minutes and retry
• Check if maintenance is scheduled
• Monitor our status page for updates

​

🛠️ Debugging Tips

​

Enable Debug Logging

// Add debug headers to see what's happening
const response = await fetch('/api/v1/email/send', {
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'X-Debug': 'true'
  }
});

console.log('Response headers:', response.headers);
console.log('Response body:', await response.json());

​

Check Request Format

# Test your API call with curl
curl -X POST https://api.posthoot.com/api/v1/email/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Test Email",
    "body": "Hello World"
  }'

​

📞 Still Having Issues?

1. Check our logs: Enable debug mode to see detailed error messages
2. Review recent changes: Did you recently update your code or configuration?
3. Contact support: Include your request ID and error details