Error codes

Complete reference for auto-post.io error codes and their solutions.

Error code format

Code structure

Category: Error type (API, AUTH, CONTENT, etc.)
Severity: Error impact (FATAL, ERROR, WARN, INFO)
Specific code: Unique error identifier
Human message: User-friendly description

Example format

AUTH_001: Authentication failed - Invalid API key
CONTENT_003: Content generation failed - Insufficient credits
API_005: Rate limit exceeded - Too many requests

Authentication errors (AUTH_xxx)

AUTH_001: Invalid API key

Description: The provided API key is invalid or expired Causes:

Incorrect API key
Expired key
Revoked access Solution:
Verify API key in dashboard
Generate new key if needed
Check key permissions

AUTH_002: Insufficient permissions

Description: User lacks required permissions for this action Causes:

Role-based access restrictions
Feature limitations
Account suspension Solution:
Check user role and permissions
Contact administrator for access
Upgrade plan if needed

AUTH_003: Two-factor authentication required

Description: Account requires 2FA verification Causes:

Security policy requirements
Suspicious activity detected
New device login Solution:
Complete 2FA verification
Use trusted device
Contact support if issues persist

AUTH_004: Account locked

Description: Account temporarily locked due to security concerns Causes:

Multiple failed login attempts
Suspicious activity
Policy violations Solution:
Wait for automatic unlock (usually 30 minutes)
Contact support for immediate assistance
Review security practices

AUTH_005: Session expired

Description: User session has expired Causes:

Inactivity timeout
Security policy
Server restart Solution:
Log in again
Check session timeout settings
Enable "remember me" option

Content generation errors (CONTENT_xxx)

CONTENT_001: AI model unavailable

Description: Selected AI model is currently unavailable Causes:

Service outage
Model maintenance
High demand Solution:
Try alternative AI model
Check service status page
Retry after a few minutes

CONTENT_002: Content generation timeout

Description: Content generation took too long Causes:

Complex content requirements
High server load
Network issues Solution:
Simplify content requirements
Reduce content length
Try again later

CONTENT_003: Insufficient credits

Description: Not enough credits to generate content Causes:

Credit exhaustion
Expired credit allocation
Plan limitations Solution:
Purchase additional credits
Upgrade plan
Wait for monthly reset

CONTENT_004: Content quality threshold not met

Description: Generated content failed quality checks Causes:

Low SEO score
Poor readability
Inappropriate content Solution:
Adjust quality requirements
Adjust generation settings
Use different AI model

CONTENT_005: Prompt validation failed

Description: Content prompt failed validation Causes:

Inappropriate content
Policy violations
Format errors Solution:
Review and modify prompt
Check content policies
Ensure proper formatting

API errors (API_xxx)

API_001: Invalid request format

Description: API request format is invalid Causes:

Malformed JSON
Missing required fields
Invalid data types Solution:
Validate request format
Use proper data types

API_002: Resource not found

Description: Requested resource does not exist Causes:

Incorrect resource ID
Deleted resource
Permission issues Solution:
Verify resource ID
Check resource exists
Confirm access permissions

API_003: Method not allowed

Description: HTTP method not supported for this endpoint Causes:

Incorrect HTTP method
Endpoint limitations
API version issues Solution:
Use correct HTTP method
Verify API version

API_004: Rate limit exceeded

Description: Too many API requests in time period Causes:

High request frequency
Plan limitations
Bot activity Solution:
Implement rate limiting
Upgrade plan for higher limits
Use exponential backoff

API_005: Internal server error

Description: Server encountered unexpected error Causes:

System failure
Database issues
Third-party service problems Solution:
Retry request after delay
Check service status
Contact support if persistent

Platform integration errors (PLATFORM_xxx)

PLATFORM_001: WordPress connection failed

Description: Cannot connect to WordPress site Causes:

Invalid credentials
Plugin conflicts
Server issues Solution:
Verify WordPress credentials
Check plugin compatibility
Test site connectivity

PLATFORM_002: Wix API error

Description: Wix API returned error Causes:

Invalid API key
Permission issues
Service outage Solution:
Refresh Wix API key
Check app permissions
Monitor Wix service status

PLATFORM_003: Webflow API timeout

Description: Webflow API request timed out Causes:

Slow response
Large data transfer
Network issues Solution:
Reduce request size
Implement retry logic
Check network connectivity

PLATFORM_004: Platform authentication expired

Description: Platform authentication has expired Causes:

Connection session expired
API key rotation
Security policy Solution:
Re-authenticate with platform
Reconnect your integration
Update connection settings

PLATFORM_005: Platform feature not supported

Description: Requested feature not available on platform Causes:

Platform limitations
Version incompatibility
Feature deprecation Solution:
Check platform documentation
Update platform version
Use alternative features

Campaign errors (CAMPAIGN_xxx)

CAMPAIGN_001: Campaign not found

Description: Specified campaign does not exist Causes:

Incorrect campaign ID
Deleted campaign
Permission issues Solution:
Verify campaign ID
Check campaign list
Confirm access permissions

CAMPAIGN_002: Campaign configuration invalid

Description: Campaign settings are invalid Causes:

Missing required fields
Invalid settings
Configuration conflicts Solution:
Review campaign settings
Check required fields
Resolve configuration conflicts

CAMPAIGN_003: Campaign already running

Description: Cannot modify running campaign Causes:

Campaign in progress
Scheduled publications pending
Resource conflicts Solution:
Pause campaign first
Wait for completion
Use proper modification procedures

CAMPAIGN_004: Insufficient campaign resources

Description: Not enough resources for campaign Causes:

Credit shortage
Team member limits
Platform capacity Solution:
Allocate more credits
Add team members
Upgrade plan

CAMPAIGN_005: Campaign schedule conflict

Description: Campaign scheduling conflicts detected Causes:

Overlapping publication times
Resource conflicts
Platform limitations Solution:
Adjust publication schedule
Resolve resource conflicts
Stagger campaign timing

File and media errors (FILE_xxx)

FILE_001: File upload failed

Description: File could not be uploaded Causes:

File size exceeded
Invalid file format
Network issues Solution:
Check file size limits
Verify supported formats
Retry upload

FILE_002: File not found

Description: Requested file does not exist Causes:

Incorrect file path
Deleted file
Permission issues Solution:
Verify file location
Check file exists
Confirm access permissions

FILE_003: File format not supported

Description: File format is not supported Causes:

Unsupported media type
Corrupted file
Version incompatibility Solution:
Use supported formats
Verify file integrity
Convert file format

FILE_004: File size exceeded

Description: File exceeds size limits Causes:

Large file dimensions
High resolution
Plan limitations Solution:
Compress file
Reduce dimensions
Upgrade plan

FILE_005: File processing failed

Description: File processing encountered errors Causes:

Corrupted file
Processing timeout
Resource limitations Solution:
Verify file integrity
Retry processing
Check system resources

Billing and payment errors (BILLING_xxx)

BILLING_001: Payment failed

Description: Payment processing failed Causes:

Invalid payment method
Insufficient funds
Bank declined Solution:
Update payment method
Verify account balance
Contact bank

BILLING_002: Subscription expired

Description: Subscription has expired Causes:

Payment failure
Plan cancellation
Billing issues Solution:
Update payment method
Renew subscription
Contact billing support

BILLING_003: Plan limit exceeded

Description: Plan limits have been exceeded Causes:

Resource overuse
Feature limitations
User count exceeded Solution:
Upgrade plan
Reduce usage
Remove unused resources

BILLING_004: Invoice not found

Description: Requested invoice does not exist Causes:

Incorrect invoice ID
Invoice not generated
Access permissions Solution:
Verify invoice ID
Check billing history
Confirm access rights

BILLING_005: Refund processing failed

Description: Refund could not be processed Causes:

Refund period expired
Payment method issues
Policy restrictions Solution:
Check refund policy
Update payment method
Contact billing support

Error handling best practices

Client-side handling

javascript

// Error handling example
try {
  const response = await fetch('/api/generate', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(requestData)
  });
  
  if (!response.ok) {
    const error = await response.json();
    handleApiError(error);
    return;
  }
  
  const result = await response.json();
  processResult(result);
} catch (error) {
  handleNetworkError(error);
}

function handleApiError(error) {
  switch (error.code) {
    case 'CONTENT_003':
      showUpgradePrompt();
      break;
    case 'API_004':
      scheduleRetry();
      break;
    case 'AUTH_001':
      redirectToLogin();
      break;
    default:
      showGenericError(error.message);
  }
}

Server-side logging

javascript

// Error logging example
const logError = (error, context) => {
  const errorLog = {
    timestamp: new Date().toISOString(),
    code: error.code,
    message: error.message,
    context: context,
    stack: error.stack,
    userId: context.userId,
    requestId: context.requestId
  };
  
  // Log to monitoring system
  logger.error('API Error', errorLog);
  
  // Send to error tracking service
  errorTracker.captureException(error, {
    tags: { errorCode: error.code },
    extra: context
  });
};

Getting help with errors

Self-service resources

Error code lookup: Search this documentation
Community forums: User discussions
Knowledge base: Troubleshooting guides
Status page: Service availability

Support information

When contacting support about errors, provide:

Error code: Specific error identifier
Error message: Full error text
Steps taken: What you were doing
System info: Browser, OS, device details
Timestamp: When error occurred

Prevention strategies

Input validation: Prevent invalid requests
Rate limiting: Avoid API limits
Error monitoring: Track error patterns
Regular updates: Keep systems current

Pro Tip

Always include the full error code and message when requesting support. This helps us diagnose and resolve issues much faster.

Error codes ​

Error code format ​

Code structure ​

Example format ​

Authentication errors (AUTH_xxx) ​

AUTH_001: Invalid API key ​

AUTH_002: Insufficient permissions ​

AUTH_003: Two-factor authentication required ​

AUTH_004: Account locked ​

AUTH_005: Session expired ​

Content generation errors (CONTENT_xxx) ​

CONTENT_001: AI model unavailable ​

CONTENT_002: Content generation timeout ​

CONTENT_003: Insufficient credits ​

CONTENT_004: Content quality threshold not met ​

CONTENT_005: Prompt validation failed ​

API errors (API_xxx) ​

API_001: Invalid request format ​

API_002: Resource not found ​

API_003: Method not allowed ​

API_004: Rate limit exceeded ​

API_005: Internal server error ​

Platform integration errors (PLATFORM_xxx) ​

PLATFORM_001: WordPress connection failed ​

PLATFORM_002: Wix API error ​

PLATFORM_003: Webflow API timeout ​

PLATFORM_004: Platform authentication expired ​

PLATFORM_005: Platform feature not supported ​

Campaign errors (CAMPAIGN_xxx) ​

CAMPAIGN_001: Campaign not found ​

CAMPAIGN_002: Campaign configuration invalid ​

CAMPAIGN_003: Campaign already running ​

CAMPAIGN_004: Insufficient campaign resources ​

CAMPAIGN_005: Campaign schedule conflict ​

File and media errors (FILE_xxx) ​

FILE_001: File upload failed ​

FILE_002: File not found ​

FILE_003: File format not supported ​

FILE_004: File size exceeded ​

FILE_005: File processing failed ​

Billing and payment errors (BILLING_xxx) ​

BILLING_001: Payment failed ​

BILLING_002: Subscription expired ​

BILLING_003: Plan limit exceeded ​

BILLING_004: Invoice not found ​

BILLING_005: Refund processing failed ​

Error handling best practices ​

Client-side handling ​

Server-side logging ​

Getting help with errors ​

Self-service resources ​

Support information ​

Prevention strategies ​