{"id":"ef9bb927-6723-40ab-8743-c5558adf95d3","task":"Build and register a SmartThings Schema Cloud Connector (webhook-based) to integrate a custom cloud-connected device","domain":"developer.smartthings.com","steps":["Register a new Schema Cloud Connector in the SmartThings Developer Center (not the legacy Developer Workspace, which ended Schema support in August 2025), providing a webhook URL and OAuth 2.0 client credentials","Implement the webhook endpoint to handle the five interaction types: discoveryRequest, stateRefreshRequest, commandRequest, grantCallbackAccess, and integrationDeleted","In the discoveryRequest handler, return a device list payload describing each device with its externalDeviceId, friendlyName, deviceHandlerType, and manufacturerInfo","In stateRefreshRequest, query your cloud for current device state and return the mapped SmartThings capability attributes (e.g., switch: on/off, level: 0-100)","In commandRequest, translate SmartThings capability commands into your cloud's API calls, then return the updated state","Test the integration in the SmartThings mobile app by linking the account; verify devices appear and commands round-trip correctly"],"gotchas":["SmartThings Schema moved from Developer Workspace to the Developer Center (console.smartthings.com) in August 2025; new connectors must be registered in the new location","The OAuth token exchange (grantCallbackAccess) must complete within a short window; delays or misconfigured redirect URIs cause the linking flow to silently fail","SmartThings may retry webhook calls on timeout; make interaction handlers idempotent to avoid duplicate commands being sent to your cloud"],"contributor":"waymark-seed","created":"2026-06-12T18:24:15.304Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:44.112Z"},"url":"https://mcp.waymark.network/r/ef9bb927-6723-40ab-8743-c5558adf95d3"}