How to subscribe SSE event using endpoints https://api.smartthings.com/subscriptions?

Developer Programs Writing SmartApps
1

Hello,

Is there any document that explains clearly how to install a smartapp in 2025/2026.
I’ve create a Webhook_smart_app using the rest api, I can see it in the CLI listing with smartthings apps xxx. But I’m unable to install it.

I know that previously I was able to install it from smarthings apps on IOs.
But I can’t find anymore the options in IOs apps to do the install.
Have to said that I’ve already succeed to do this.

Any guidance would be apreciated.

Laurent

2

Ok, i’ve find back how to recreate my installed apps.
But facing another issues:

I’m using this endpoint : https://api.smartthings.com/subscriptions to register global subscriptions.
I call it using POST method, with a header and payload of this sort:

Authorization: Bearer 8243ad0a-xxxx-xxxx-xxxx-xxxx
Host: api.smartthings.com
Content-Length: 378
Accept: application/json; charset=UTF-8
Content-Type: application/json

{
“name”: “mySub”,
“version”: 20250122,
“clientDeviceId”: “iapp_xxxxx-xxxxx-xxxxx-xxxx”,
“subscriptionFilters”: [
{
“type”: “LOCATIONIDS”,
“value”: [
“xxxx-xxxx-xxxxx-xxxxx”
],
“eventType”: [
“DEVICE_EVENT”,
“DEVICE_LIFECYCLE_EVENT”,
“DEVICE_HEALTH_EVENT”
]
}
]
}

But now, I’ve end up with 403 error each time.
I’ve don’t know what I’m missing.

  • Does this endpoint need special Bearer token to work, or can I use it with the token of my global SmartApp ?
  • Does this endpoint need specific scope ?

Any help or guidance would be really appreciated !

Laurent.

3

@**nayelyz
**
If you can help me on this subject.
I work on an integration between an home automation solution and smartthings.
This is somethings like was done for HomeAssistant.

Since modification this weekend, I’m not able anymore to register SSE subscription.
Every call end with 403 errors. If you can help me having little more background about the error, it will be really great.

Laurent

4

I’ve realized that their seems to exist a new scope “sse”.
But I don’t understand how I can assign this sse scope to my application.

5

Hi @lo92fr

I’ve already replied by email.