1. Error Codes
  • Getting Started
  • Locations
    • Location Attributes
      MARKDOWN
    • Photo specifications for your business location
      MARKDOWN
    • Star and Unstar Photos
      MARKDOWN
    • Create a new business location
      POST
    • Update business location
      POST
    • List all locations
      GET
    • List particular locations
      GET
    • Search locations
      GET
    • Get locations by store codes
      GET
    • Upload Photos to a Location
      POST
    • Check Bulk Photo Upload Status
      GET
    • Star/Unstar Location Photos
      POST
    • Delete Location Photos
      POST
    • Archive multiple locations
      POST
    • Cancel scheduled location archival
      POST
    • Activate archived locations
      POST
    • List Active Subscriptions
      GET
    • Get a list of supported countries and their states
      GET
    • Get SubCategories and AdditionalCategories
      GET
    • Get Site Details for Your Plan
      GET
  • Organizing locations
    • Organizing locations
      MARKDOWN
    • Create a new folder
      POST
    • List all folders
      GET
    • List all folders under an account in hierarchical structure
      GET
    • Get details of a folder
      GET
    • Rename a folder
      POST
    • Add locations to a folder
      POST
    • Remove locations from a folder
      POST
    • Delete a folder
      POST
    • List locations under a folder
      GET
    • List all tags
      GET
    • List locations by tags
      GET
    • Add location to a tag
      POST
    • Remove location from a tag
      POST
  • User Management
    • User Attributes
    • Create User with Role
    • List Users
    • List Users by ID
    • Add Locations to User
    • Add User and folder
    • List User Roles
    • Add folders to user
    • List User Resources
    • Update a User
    • Remove Folders for User
    • Remove Locations for User
  • Grid Rank
    • Local Rank Grid
    • Create Rank Grid Report
    • Fetch All Grid Reports for Location
    • Fetch Rank Grid Report By ID
  • Review Campaigns
    • Review Campaign Info Attributes
    • Create a review campaign
    • Add customers to a review campaign
    • List review campaigns
    • List review campaign customers
  • Listings
    • Listings
    • Listing Status Webhooks
    • Get premium listings
    • Get voice listings for a location
    • Get duplicate listings for a location
    • Get all duplicate listings for an account
    • Mark listings as duplicates
    • Mark listings as not duplicates
    • Get AI listings
  • Connected Accounts
    • Connected Accounts
    • Connect Google Profile to Account
    • Connect Facebook Page to Account
    • List all connected accounts
    • List folders under a Google account
    • Create GMB Listing
    • Disconnect GMB Profile
    • Disconnect Facebook Account
    • Fetch Connected Account Details
    • Trigger New Matches
    • List Connection Suggestions
    • Fetch Connected Account Listings
    • Confirm Connected Account Matches
    • Connect a location with a listing of a connected account
    • Disconnect Location from Listing
  • Rankings
    • Rankings Analytics Attributes
    • Add keywords
    • List Keywords
    • Get keywords performance
    • Archive a keyword
    • Get Rollup Keyword Performance
    • Get Rankings Distribution By Time
  • Profile Analytics
    • Profile Analytics
    • Get Bing Analytics
    • Get Facebook Page Analytics
    • Get Google My Business Analytics
  • Reviews
    • Reviews
    • Review Sources
      • Get a list of interaction sources for location
      • Get a list of interaction sources for account
      • Add / Edit interaction source
    • Fetch all interactions
    • List Interactions by IDs
    • Respond to an Interaction
    • Edit Response for Interaction
    • Archive Response for Interaction
    • Get Interaction Analytics
    • Add Review Widget
    • Edit Review Widget
  • Automations
    • Temporary Close Location with a reopening date
  • Error Codes
    • ERROR CODES
      MARK
  1. Error Codes

ERROR CODES

MARK
https://api.synup.com/api/v4

Error Codes#

IMPORTANT : Error Codes are available to sandbox users only for now. Error Codes will be available in production on August 5th, 2019.

What are Error Codes?#

When you encounter an error, the error response will contain an Error Code and the respective Message for that error code. The response also contains a context field that will give you the specific value of the input variable that has caused the error.
The context will be empty in cases where it is not relevant.
In the tables below, variables denoted in orange with a prepended $ will have context information
Given below is an example error response for attempting to rename a folder that does not exist.
{
    "data": {
        "renameFolder": null
    },
    "errors": [
        {
            "message": "Folder Does Not Exist",
            "context": {},
            "code": "SY10039"
        }
    ]
}

Locations Error Codes#

Error CodeMessage
SY10038Location Does Not Exist
SY10039Folder Does Not Exist
SY10040Cannot add more than 10 tags
SY10046Invalid location id
SY10047Folder does not exist for the account id
SY10048User doesn't have access to folder
SY10049Root Folder Cannot Be Deleted.
SY10050Access To Folder Denied.
SY10051Folder Belonging To Location not found.
SY10052Location Is Not Assigned To Any Folder. Location Is In Root And Root Locations Cannot Be Deleted.
SY10056Site is not valid for the location disconnection
SY10057Location is not connected for the site
SY10058Root Folder For account Not Present
SY10063Only a maximum of 4 photos can be starred or unstarred
SY10064Only additional photo types can be starred or unstarred
SY90001Not Authorized to access this resource
SY90005Invalid Token
SY90003Operation not permitted
SY90006System Internal Error
SY10001Location ${name} needs to be between 2
SY10002Additional Info needs to be a maximum of 1024 char
SY10003Plan Id needs to be present
SY10004Account Id needs to be present
SY10005Description needs to have a minimum of 200 characters.
SY10006Owner Email is of incorrect
SY10007Enabled Site Ids are invalid
SY10008Year of Incorporation is not valid
SY10009Country is invalid
SY10010State is invalid
SY10011Street is invalid
SY10012City is invalid
SY10013Postal code is not present.
SY10014Postal code is invalid
SY10015Phone Number is invalid
SY10016Payment Method is invalid
SY10017Location with same name, phone number and zip code has already been added.
SY10018Facebook Url for the location is invalid
SY10019Twitter Url for location is invalid. Must be in the format http(s)://twitter.com/handle or http(s)://x.com/handle.
SY10020Linkedin Url for location is invalid.
SY10021Google Plus Url for location is invalid.
SY10022Business Url for location is invalid.
SY10023Video links are invalid.
SY10024Primary Sub Category is blank.
SY10025Primary Subcategory is invalid
SY10026A total of 9 additional categories are allowed
SY10027SubCategory is invalid
SY10028Some additional categories are not valid
SY10029Couldn't geolocate with the given address. Please provide a valid address
SY10030The provided coordinates and address do not match
SY10031All days of the week should be included in the business hours
SY10032Invalid operating hours for each day of the week
SY10033Business Hours should be in 12 hours format and no trailing spaces. eg '09:00am'
SY10034Bad image URL ${bad_url}
SY10035Invalid folder id
SY10036Unsupported country
SY10037Tag limit is 10
SY10041Failed to add tag: ${tag}
SY10042Invalid tag name: ${tag}
SY10043Failed to remove tag
SY10045Mutation not permitted
SY10053Only additional photo types can be starred or unstarred
SY10054Only a maximum of 4 photos can be starred or unstarred
SY10060Can only upload one logo
SY10061Can only upload one cover image
SY10062Only additional photo types can be removed
SY10065Invalid Photo format (jpeg or png allowed)
SY10066Photo cannot be blank
SY10067Photo size needs to be between 10kb to 5mb
SY10068Unknown error occurred
SY10069Topline Error
SY10070A location is already being processed for this account
SY10071Special characters aren't allowed in tags
SY10072Store Id has to be unique for an account
SY10073Business Hours are overlapping
SY10074The entered business hour slots are reversed. Please ensure the first time slot precedes the second time slot
SY10075The entered business hours are incorrect. Please ensure the opening hours precede the closing hours
SY10076The entered business hours overlap. Please check or use a single time slot under Open
SY10077Offerings Item name should be present
SY10078Offerings Section name should be present
SY10079Section name cannot be the same as List name
SY10080Section name already exists in the Menu
SY10081Section name cannot be same as Item name
SY10082Item name cannot be the same as List name
SY10083Item name cannot be the same as Section name
SY10084Item name already exists in the Menu
SY10086Hide Address has an incorrect value
SY10087Tenure is required
SY10088Tenure not active for account
SY10089Invalid Attribute Id
SY10090Attribute already deleted
SY10091Special hours can not be added without adding operational hours
SY10092Operational hours can not be closed for all days of the week
SY10093Split Hours can not exceed 24 hours
SY10123Tags can not be added for freemium locations
SY10111Owner's Email is Mandatory
SY10112Business Owner Name is Mandatory
SY10110Cannot edit package
SY10124Maximum of only $free_trial_location_limit locations allowed
SY10109Entity does not exist
SY85002AddOn not enabled
SY10095Voice already enabled for this location
SY10108Some exception occurred while voice billing
SY10118This currency code does not correspond to the locations assigned to this menu. Please select a valid currency code
SY10094Root Folder not found
SY10117This location cannot be assigned to this menu. Please select a location that corresponds to the currency code chosen in this menu
SY10114Name already taken for this account
SY10115Please choose a currency code
SY10116This currency code is currently not supported. Please choose a valid currency code
SY10121Offerings List's display name cannot be blank
SY10119Menu name cannot be same as Section name
SY10120Menu name cannot be same as Item name
SY10122We could not add this location as you have exceeded your Freemium Usage limits. Please email Support to upgrade your package

Profile Analytics Error Codes#

Error CodeMessage
SY60101fromDate cannot be greater than toDate.
SY60102Error fetching insights for this tag.
SY60103Invalid Date
SY90001Not Authorized to access this resource
SY90002Invalid Id
SY90005Invalid Token
SY60203Insufficient permission to update ROIs
SY60201Id can't be blank

Interactions Error Codes#

Error CodeMessage
SY90002Invalid Id
SY90003Operation not permitted
SY90001Not Authorized to access this resource
SY90006System Internal Error
SY90004Token has expired
SY90005Invalid Token
SY50100Note must not be empty
SY50101Widget name $name already used
SY50102Name must not be empty
SY50103Response content must not be empty
SY50300Response not successful: Received status code 500
SY50104Invalid site name provided
SY50105Invalid URL provided
SY50106Cannot update connected sites
SY50107Template does not exist
SY50108User config does not exist
SY50109Template name already used
SY50110ratings should be between [1-5]
SY50111Invalid SiteUrls
SY50112Name can't be blank
SY50113Content can't be blank
SY50501SY50501 Fields must not be empty
SY50114Answer must not be empty
SY50115Question must not be empty
SY50116Owner has already responded to the question
SY50117Duplicate SiteUrls
SY50118Duplicate Ratings
SY50119Duplicate Location Ids
SY50121Google Reviews can only be replied to once
SY50131Trustpilot connection failed
SY50132Interaction Request does not exist
SY50133Invalid Trustpilot Review Source
SY82001Connection does not exist

Rankings Error Codes#

Error CodeMessage
SY20105Keyword with id $keyword_id not found
SY20106Keyword with name $keyword already exists
SY20200Keyword can't be blank
SY20201Keyword must be minimum 2 characters
SY20202Keyword can't be more than 255 characters
SY20100Keywords can't be blank
SY20101Location Ids can't be blank
SY90001Not authorized to access this resource
SY90002Invalid Id
SY90003Operation not permitted
SY90005Invalid token
SY90006System Internal Error
SY20103Maximum keyword limit reached
SY20006Please provide a valid role
SY20009Rankings not enabled for this account
SY20104Invalid Keyword Id

Review Campaigns Error Codes#

Error CodeMessage
SY90001Not Authorized to access this resource
SY90002Invalid id
SY90003Operation not permitted
SY90005Invalid Token
SY90007Resource Not Found
SY90006System Internal Error
SY30038Invalid message id
SY30006The Global Setting for the location and account does not exists.
SY30039The date fields are not set up correctly. Please review the dates and try again.
SY30040Both before and after should not be present
SY30001Either email or phone has to be present
SY30002Phone must be a number
SY30003Email already exists
SY30033Phone $phone is not a number
SY30034Email $email has already been taken
SY30035Phone $phone has already taken
SY30004Account id can't be blank
SY30005Location id can't be blank
SY30016Insufficient Permissions To Add Customers To Campaigns.
SY30017Validation for some of your customers failed
SY30018Insufficient Permissions To Create Campaigns.
SY30019INVALID OPERATION: Construction Of Campaign Before Construction Of Global Settings.
SY30020The Global Setting for the location id: $location_id and account id: $account_id already exists.
SY30021Invalid Input. Missing either Rating or Feedback or Clicked Key in the input.
SY30022Only one of clicked_key, feedback or rating can be present at a time.
SY30023The customer with id: $customer_id does not exist.
SY30024Rating and feedback cannot be updated simultaneously.
SY30025Rating already present for this customer.
SY30026The clicked link does not exist.
SY30027Invalid link.
SY30028Insufficient Permissions To Manage Global Settings.
SY30029The Global Setting for the location id: $location_id and account id: '$account_id' does not exist.
SY30030Insufficient Permissions To Update SMS Credits.
SY30031credits could not be updated.
SY30029The Global Setting for the location id: $location_id and account id: '$account_id' does not exist.
SY30030Insufficient Permissions To Update SMS Credits.
SY30031credits could not be updated.
SY30046domain is not matching
SY30051email is invalid
SY30054From email can't be blank for a domain
SY30055Assignment can't proceed. Domain is not active
SY30048Domain is not verified
SY30049No subdomain is associated with this account

Notifications Error Codes#

Error CodeMessage
SY90001Not authorized to access this resource
SY90003Operation not permitted
SY40003Email activation failed. Please try after some time
SY40004Location does not belong to your account
SY40005Error while querying for email setting
SY40006Error while querying for agency setting
SY40007Error while querying for email notifications
SY40008Error while querying for email templates
SY40009Error while querying for recipient emails
SY40010Error while sending test email
SY40015Requested resource could not be found
SY40016Something went wrong while calling graphql end points
SY40017Error while Downloading report
SY40018Error while unsubscribing recipients
SY40019Something went wrong in notification app
SY40011Validation failed for Template: account_id can't be blank
SY40012Validation failed for Recipient: mailable_type can't be blank
SY40013Validation failed for Recipient: mailable_id can't be blank
SY40014Validation failed for Recipient: email is invalid
SY90008Error while Downloading report
SY40030Error while saving dkim details
SY40031Public domain email is not supported. Please try again with business domain email
SY85001AddOn belonging to same umbrella already enabled

Listings Error Codes#

Error CodeMessage
SY00001Permission Denied
SY00002Listing item ID not found
SY00003Invalid Site ids submitted
SY00004Location has not yet been approved
SY90007Resource Not Found
SY90007Resource Not Found
SY90002Invalid Id
SY00008Location is in archived state
SY00009No access to location
SY90001Not Authorized to access this resource
SY00028Error in processing request
SY30036Requested resource not found

Promotional Posts Error Codes#

Error CodeMessage
SY75001Invalid scheduled date
SY75003Scheduled cannot be set for active posts
SY75004Content should be present while creating a post
SY75005Content should be between 0-1500
SY75006Start date should be greater than today
SY75007Invalid start date
SY75008End date should be greater than today
SY75009Invalid end date
SY75010Start date should be more than the end date
SY75011Start time should be less than end time
SY75012The photo uploaded is too small! it must be at least 720 pixels wide and 540 pixels tall
SY75013The photo uploaded is too large! it must be at max 3000 pixels wide and 3000 pixels tall
SY75014Google account is no longer connected.
SY75015Cannot repost an event
SY75016Invalid click to action url
SY75017Can only edit scheduled or active posts
SY75018Cannot repost posts with events
SY75019Cannot set repost for expired post if it is already marked repost
SY75020Can repost only active or expired posts
SY75021Can delete only active posts
SY75022Please select a post to delete
SY75023End date should be less than today
SY75024start date should be less than end date
SY75025should be larger than 10KB and smaller than 5MB
SY75002Invalid api key
SY75026Invalid Credentials. Please reconnect
SY75039Post name should be present
SY75027Post start timing should be for a future timing
SY75028Post end timing should be greater than start timing
SY75029Scheduled start timing should be for a future timing
SY75030Scheduled end timing should be greater than start timing
SY75031Facebook doesn't support Event, Covid19 and Offer Posts
SY75032Facebook offer requires cta
SY75033Offer requires start and end timings to be present
SY75034Event requires start and end timings to be present
SY75035Google event requires title to be present
SY75036Facebook offer requires media to be present
SY75038Google offer requires cta
SY75040Crossed allowed Google post content length
SY75041Crossed allowed Facebook post content length
SY75042Facebook offer requires title to be present
SY75044Google post required title to not exeed 58 characters
SY75045Video file size exceeds Facebook's maximum limit of 10 GB
SY75046Video duration exceeds Facebook's maximum limit of 240 minutes
SY75047Video frame rate exceeds Facebook's maximum limit of 30 fps
SY75048Video width is below Facebook's minimum requirement of 1200px
SY75049Video width exceeds Facebook's maximum limit of 4000px
SY75050Video aspect ratio is outside Facebook's supported range of 9:16 to 16:9
SY75051Video format is not supported by Facebook
SY75052Unable to validate video file. Please ensure the video URL is accessible.
SY75053Unable to validate image file. Please ensure the image URL is accessible.
SY75054Image format is not supported by Facebook
SY75055Image file size exceeds Facebook's maximum limit of 10 MB
SY75056Image width is below Facebook's minimum requirement of 250px
SY75057Image width exceeds Facebook's maximum limit of 1936px
SY75058Image height is below Facebook's minimum requirement of 250px
SY75059Image height exceeds Facebook's maximum limit of 1936px
SY75060Image aspect ratio is outside Facebook's supported range of 1:1.91 to 1.91:1
SY75061Facebook posts cannot contain both images and videos. Please use either images OR video, not both.
SY75062Facebook posts can contain a maximum of 10 images.

User Error Codes#

Error CodeMessage
SY80100Invalid location
SY80101$url is not a valid url
SY80102Location is in archived state
SY80103Access to reseller denied
SY80104Site not included in Plan
SY80010Permission Denied For This Operation
SY80011Role does not belong to your account
SY81000Email is a mandatory field
SY81001Email should be unique
SY81003Invalid Email Format
SY81004Password is a mandatory field
SY81005Confirmation password required for new password
SY81006Password must be between 8 and 128 characters
SY81007First Name should not be more than 60 characters
SY81008Last Name should not be more than 60 characters
SY81009First Name is a mandatory field
SY81010Cname is a mandatory field
SY81011Stripe Customer Id must be Unique
SY81012Company logo must be present
SY81013logo must be less than 1536Kb
SY81014cover must be .jpeg or .png
SY81015SMS Credit must be more than 0
SY81016You are not permitted to add $role_type
SY81017Invalid Account Id
SY81018User Already Exists
SY81019User not found
SY81020User does not belong to this account
SY81021Please accept privacy policy
SY81022Invalid Success or Error URL
SY81023This workspace has already been taken
SY81024This email has already been taken
SY81025Please enter a valid Workspace
SY81026Workspace is already setup for your account
SY81027Email/Password update requires current password
SY81028Domain should not be empty
SY81029Limit max length of subdomain to under 250 characters
SY89999Internal Server Error
SY81030Confirmation password doesn't match match new password
SY81031Limit max length of domain to under 250 characters
SY90001Not Authorized to access this resource
SY90005Invalid Token
SY90003Operation not permitted
SY90006System Internal Error
SY81057Invalid role passed

Scan Tool Error Codes#

For Scan Tool customers only#
Error CodeMessage
SY70100Invalid Business Rep Ids
SY90001Please pass a Valid authorization key

Media Error Codes#

Error CodeMessage
SY10034Bad image URL ${bad_url}
SY10060Can only upload one logo
SY10061Can only upload one cover image
SY10065Invalid Photo format (jpeg or png allowed)
SY10066Photo cannot be blank
SY10067Photo size needs to be between 10kb to 5mb
SY81012Company logo must be present
SY81013logo must be less than 1536Kb
SY81014cover must be .jpeg or .png

Request

None

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request MARK 'https://api.synup.com/api/v4'

Responses

🟢200Success
application/json
Body

Example
{}
Modified at 2025-07-31 10:50:02
Previous
Temporary Close Location with a reopening date
Built with