Assistance Required for Freshservice App Migration v2.3 → v3.0

[devopsintegrationio (DevOps Integration)]

Hello Freshservice App Support Team,

I am migrating my Freshservice app from platform version 2.3 to 3.0.
I have updated my manifest.json to include “supported_products”: [“freshservice”], but I am still receiving the following error when validating or uploading the app:

Error: “products are supported_products on localpackage”

Here is my current manifest.json:

{
“platform-version”: “3.0”,
“supported_products”: [“freshservice”],
“modules”: {
“common”: {
“events”: {
“onAppUninstall”: {
“handler”: “onAppUninstallHandler”
},
“onExternalEvent”: {
“handler”: “postServerFn”
}
},
“requests”: {
“authenticate”: {},
“axios_post”: {}
},
“functions”: {
“postServerFn”: {
“timeout”: 20
},
“onAppUninstallHandler”: {
“timeout”: 20
}
}
},
“support_ticket”: {
“location”: {
“ticket_sidebar”: {
“url”: “index.html”,
“icon”: “assets/images/icon.svg”
}
}
},
“change_request”: {
“location”: {
“change_request_sidebar”: {
“url”: “index.html”,
“icon”: “assets/images/icon.svg”
}
}
}
},
“installation”: {
“scopes”: [
“account”,
“tickets.read”,
“tickets.write”,
“changes.read”,
“changes.write”
]
},
“dependencies”: {
“axios”: “0.20.0”
},
“engines”: {
“node”: “18.20.8”,
“fdk”: “9.8.1”
}
}

Could you please guide me on what I might be missing to make my app compatible with v3.0?

Thank you for your help.

Best regards,
Bill Greer

[Debjani (Debjani Chatterjee)]

Hey @devopsintegrationio!

Ah, I see what’s happening - you’ve got some Platform 2.x patterns still in your manifest. The error about supported_products is the giveaway - that property doesn’t exist in Platform 3.0.

Here’s what needs fixing:

• Remove "supported_products": ["freshservice"] completely (2.x only)
• Change "support_ticket" to "service_ticket" (that’s the Freshservice module name)
• Change "change_request" to "service_change" (correct 3.0 module)
• Update location "change_request_sidebar" to "change_sidebar"
• Drop the entire "installation": { "scopes": [...] } block (not needed in 3.0)

Here’s your corrected manifest:

{
  "platform-version": "3.0",
  "modules": {
    "common": {
      "events": {
        "onAppUninstall": {
          "handler": "onAppUninstallHandler"
        },
        "onExternalEvent": {
          "handler": "postServerFn"
        }
      },
      "requests": {
        "authenticate": {},
        "axios_post": {}
      },
      "functions": {
        "postServerFn": {
          "timeout": 20
        },
        "onAppUninstallHandler": {
          "timeout": 20
        }
      }
    },
    "service_ticket": {
      "location": {
        "ticket_sidebar": {
          "url": "index.html",
          "icon": "assets/images/icon.svg"
        }
      }
    },
    "service_change": {
      "location": {
        "change_sidebar": {
          "url": "index.html",
          "icon": "assets/images/icon.svg"
        }
      }
    }
  },
  "dependencies": {
    "axios": "0.20.0"
  },
  "engines": {
    "node": "18.20.8",
    "fdk": "9.8.1"
  }
}

The main thing - Platform 3.0 doesn’t use product or supported_products at all. It’s all about modules now. Just having the right module names (service_ticket, service_change) tells the platform this is a Freshservice app.

You can check out the Platform 3.0 manifest docs for more details on the structure.

Try fdk validate now and you should be good. Let me know how it goes!

[devopsintegrationio (DevOps Integration)]

Hi

Thanks for the help

The issue has been resolved

Thanks
Bill Greer