Max installs exceeded for OAuth SmartApp 20 installs - documentation says it should be 500

Developer Programs
1

Hello,

I am the tech lead of company using a SmartThings OAuth app.

Our SmartApp is returning the following error message:

error=max_installs_exceeded&error_description=The+app+cannot+exceed+a+max+of+20+installs&state=…

This suggests we cannot onboard more than 20 users. However, the documentation states 500 before needing to fill out a form OAuth Integrations | Developer Documentation | SmartThings

Is there some other step we need to take? This is an urgent problem for us as customers are trying to sign up but can’t.

Thank you,
Alex

2

Tagging @nayelyz

1 Like
3

Hi, @AWGNelson

As you mention this integration belongs to a company, you should contact the Partners team for further assistance.
Indeed the limit is documented as 500 and I haven’t seen recent reports about this, so, they’ll help you check your situation.
You can contact them at partners@smartthings.com

Thanks for the tag, @Andrew_Bartlett

4

Thank you! I’ve reached out via email

5

I have also seen the same issue with users maxing out at 20. With the recent change in PAT behaviour, we are starting to migrate users over to OAuth and ran into this, I wasn’t expecting to see it until 500 users. Can the documentation be updated? Thanks

Simon

6

Hi, @constantgraph

The default limit should be 500, I noticed that when I create an OAuth-In app, the property “installMetadata” is empty. As I remember this property used to tell us how many installations we had available when we created the app from the Developer Workspace (this was with authorized access which isn’t available anymore).
If yours also has this property empty, please let me know.
In the meantime, I’ll create a report about this.

7

where can I see this property? I previously used the developer workspace to create apps but now use the smartthings CLI. Interestingly, if I try and do anything with an app created via the workspace within the CLI I get an error: Cannot read properties of undefined (reading ‘url’).

8

When you query the app’s details with this CLI command:

smartthings apps appId -j

Remember to replace “appId” with the correct value.

Was this recently created? I haven’t had issues with mine but it was created like 4 years ago.

9

We have the same problem. Our app was created with the CLI in February. The installMetadata.maxInstalls property is set to 500 but we are limited to 20 installs. What should we do to increase this limit?

{
    "appName": "ahomeseersmartthingsplugin-5fcd313b-1ede-463d-b478-7f937dbad652",
    "appId": "29962c73-b391-4ae3-b51b-cc1585219c15",
    "appType": "API_ONLY",
    "principalType": "LOCATION",
    "classifications": [
        "CONNECTED_SERVICE"
    ],
    "displayName": "HomeSeer SmartThings Plugin",
    "description": "Allows HomeSeer to control SmartThings devices",
    "singleInstance": true,
    "iconImage": {
        "url": "https://homeseer.com/updates4/icons/357_HS-Logo-Sq-White-Circle-2019.png"
    },
    "installMetadata": {
        "assumedRoleCanInstall": "false",
        "maxContentLengthBytes": "64000",
        "maxInstalls": "500",
        "certified": "false",
        "restrictedMembersCanView": "false"
    },
    "owner": {
        "ownerType": "USER",
        "ownerId": "d5c262d9-cd57-1c6d-4e81-001d20cda9ac"
    },
    "createdDate": "2025-02-26T13:49:05Z",
    "lastUpdatedDate": "2025-04-28T17:39:54Z",
    "apiOnly": {},
    "ui": {
        "pluginUri": "",
        "dashboardCardsEnabled": false,
        "preInstallDashboardCardsEnabled": false
    }
}
10

well, actually, it now seems to work this morning, and I see that our app was updated yesterday, so maybe someone added this missing “500” maxInstalls property?

11

Hi, @spud, @constantgraph

As you contacted the Partners’ team, they fixed it for you, so you now have the default of 500 installs.

12

yep. It is now working for us after contacting the partners team. The maxInstalls property is now also showing 500 but I don’t know what it was before.

1 Like
13

Next question is how can we increase this default limit of 500 ? And is there a way to check the current number of installs in order to know if we are close to the limit?
Thanks

14

There’s a form in the documentation that you need to fill up, it will go to the corresponding team. However, as our team (Developer Support) isn’t involved in those requests, we cannot provide you with updates to your request.

Sorry, but there isn’t a current way to check how many installs have been used so far through the API.
What you can do is having a counting process on your side to check how many installed apps have been created based on your integration (requesting an Access Token with your App ID)
The installation is counted by locations where the user has authorized access, which issues a new installedAppId along with the Access Token.

15

If apps are uninstalled does it reduce the installed count?

1 Like