Error Codes

Understanding Synoveo error codes helps you resolve issues quickly.

Error Response Format

When something goes wrong, Synoveo returns a structured error with a code and message:

{
  "status": "error",
  "error": {
    "code": "TIER_LIMIT_REACHED",
    "message": "Your plan supports up to 30 units. Upgrade to add more rooms."
  }
}

Authentication Errors

Code	What It Means	How to Fix
`AUTH_REQUIRED`	You need to be logged in	Log in to the console
`TOKEN_EXPIRED`	Your session has expired	Log in again
`GOOGLE_AUTH_EXPIRED`	Google connection needs renewal	Reconnect your Google account in Settings

Permission Errors

Code	What It Means	How to Fix
`FORBIDDEN`	Your role does not have access to this feature	Ask the property Owner to upgrade your role
`LOCATION_ACCESS_DENIED`	You do not have access to this property	Contact the property Owner
`TIER_LIMIT_REACHED`	Your plan does not have enough unit capacity	Upgrade your plan in Settings > Billing
`FEATURE_NOT_AVAILABLE`	This feature is not available on your plan	Check your plan details

Booking Errors

Code	What It Means	How to Fix
`BOOKING_NOT_FOUND`	The booking could not be found	Check the booking ID and try again
`BOOKING_CONFLICT`	The room is already booked for those dates	Choose different dates or a different room
`INVALID_DATES`	The check-in or check-out date is invalid	Ensure check-out is after check-in
`PAYMENT_FAILED`	The guest's payment did not go through	Ask the guest to try a different payment method

Room and Rate Errors

Code	What It Means	How to Fix
`ROOM_NOT_FOUND`	The room could not be found	Check the room still exists in your setup
`RATE_NOT_FOUND`	The rate plan could not be found	Verify the rate plan in Rates and Availability
`INVALID_RATE`	The rate amount is not valid	Ensure the rate is a positive number

Channel Errors

Code	What It Means	How to Fix
`CHANNEL_SYNC_FAILED`	Failed to update a booking site	Check the channel sync log for details
`CHANNEL_NOT_CONNECTED`	The channel is not connected	Set up the channel connection first
`MAPPING_INCOMPLETE`	Rooms are not fully mapped to the channel	Complete room mapping in channel settings
`RATE_LIMITED`	Too many requests to the booking site	Wait a few minutes and try again

Validation Errors

Code	What It Means	How to Fix
`INVALID_INPUT`	The information you provided is not valid	Check the form for highlighted errors
`MISSING_FIELD`	A required field was not filled in	Complete all required fields
`INVALID_FORMAT`	The data format is incorrect	Check the expected format (dates, phone numbers, etc.)
`CONFLICT`	A duplicate entry already exists	Change the conflicting value

Google Business Profile Errors

Code	What It Means	How to Fix
`LOCATION_NOT_VERIFIED`	Your Google listing is not verified	Complete verification in Google Business Profile
`LOCATION_NOT_FOUND`	The Google listing could not be found	Re-import your locations from Google
`GBP_UPDATE_FAILED`	Failed to update Google listing	Check your Google connection and try again

Getting Help

When contacting support, include the following to help us resolve your issue quickly:

The error code (e.g., TIER_LIMIT_REACHED)
The full error message
What you were trying to do when the error occurred
When it happened (date and approximate time)
Your property name so we can look up your account