Troubleshooting

Error Codes

Reference for Synoveo error codes

Understanding Synoveo error codes helps diagnose issues quickly.

HTTP Status Codes

CodeMeaning
200Success
201Created
400Bad Request - Invalid input
401Unauthorized - Auth required
403Forbidden - No permission
404Not Found
429Too Many Requests - Rate limited
500Server Error

Synoveo Error Codes

Authentication Errors

CodeMessageSolution
AUTH_REQUIREDAuthentication requiredLog in or provide API key
TOKEN_EXPIREDJWT token expiredRefresh token or re-login
INVALID_CREDENTIALSInvalid API credentialsCheck Client ID/Secret
GOOGLE_AUTH_EXPIREDGoogle authorization expiredReconnect Google account

Permission Errors

CodeMessageSolution
PLAN_LIMIT_EXCEEDEDPlan limit reachedUpgrade plan or remove items
FEATURE_NOT_AVAILABLEFeature not in planUpgrade to access feature
LOCATION_ACCESS_DENIEDNo access to locationCheck API key scope
FIELD_NOT_ALLOWEDField not in planUpgrade for field access

Resource Errors

CodeMessageSolution
LOCATION_NOT_FOUNDLocation doesn't existCheck location ID
BUSINESS_NOT_FOUNDBusiness doesn't existCheck business ID
LOCATION_NOT_VERIFIEDLocation not verifiedVerify in Google first

Sync Errors

CodeMessageSolution
SYNC_FAILEDSync operation failedCheck details, retry
QUOTA_EXCEEDEDSync quota exceededWait for reset or upgrade
RATE_LIMITEDToo many requestsWait and retry
INVALID_PAYLOADInvalid sync dataCheck data format

Validation Errors

CodeMessageSolution
INVALID_INPUTInput validation failedCheck request format
MISSING_FIELDRequired field missingProvide required data
INVALID_FORMATData format incorrectFix data format

Error Response Format

{
  "status": "error",
  "error": {
    "code": "SYNC_FAILED",
    "message": "Failed to sync location",
    "details": "Field 'phoneNumber' format invalid"
  }
}

Getting Help

When contacting support, include:

  1. Error code
  2. Full error message
  3. What you were doing
  4. Timestamp
  5. Location/business ID if applicable

Contact Support

On this page