Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases

Console

as

Ring

Ring Appstore API Release Notes

September 21, 2026

Documentation changes

  • Added a source for Ring product imagery to Creative resources in the Marketing Guidelines: device and product photography comes from the Ring Press Center. The Ring Appstore badge download link now sits on the badge entry itself, so every asset in the list carries the link you need to get it.

September 16, 2026

Video encryption

TAKE and E2EE — Ring is rolling out two video-encryption modes: Throw Away the Key (TAKE) and End-to-End Encryption (E2EE). During the initial rollout, a TAKE device stays visible and callable through the Ring Partner API, but video requests return encrypted content, so your app cannot read recordings or snapshots, or open a live stream. E2EE devices are not returned by any Ring Partner API, because users can't grant partner apps access to them. Your integration does not change: endpoint paths, request parameters, request bodies, response schemas, status codes, authentication, account linking, consent flow, and webhook signature verification are all unchanged. See Video encryption (TAKE and E2EE) in the Developer FAQ.

Documentation changes

  • Added the Video encryption (TAKE and E2EE) section to the Developer FAQ, covering how the two modes work, whether an app works for a user on TAKE and for a user on E2EE, what happens to a device already connected to an app when the user encrypts it, and whether the API integration needs to change. Questions in the sections that follow are renumbered.

September 15, 2026

API changes

Remove an integration from your app — Apps that use Partner-Initiated OAuth 2.0 can now unlink a Ring user with a single call: DELETE /v1/accounts/me/app-integrations with the user's access token. Ring removes the integration, revokes the user's access and refresh tokens, and sends the app_integration_removed webhook, exactly as when the user removes the app from Ring AppStore. Until now, removal was only possible from the Ring AppStore side. The call works only for Partner-Initiated OAuth 2.0 apps; apps that use one-way account linking receive 403 Forbidden. See Removing the integration.

Documentation changes

September 11, 2026

Test phase

No purchase required for staging users — Staging users no longer go through a purchase or subscription activation step to test the staging version of your app. Authorizing an account on the Test page is all it takes to start testing, even when your app is paid. This removes a step that developers told us added friction to every test cycle. Production behavior is unchanged: customers who install a paid app still complete subscription activation, and you still receive the subscription_activated webhook. Staging users continue to need an active Ring Protection plan or trial on their own Ring account, because that plan activates cloud features on the devices you test against. See Test Your Ring App Store Integration.

Documentation changes

  • Documented the change in the Testing Process section of the Develop guide, and clarified in Prerequisites that the Ring Protection plan requirement belongs to the staging user's Ring account and is separate from any fee your app charges.

  • Added Q7, "Do staging users have to purchase my app to test it?", to the Testing & certification section of the Developer FAQ. Questions in the sections that follow are renumbered.

September 9, 2026

Documentation changes

  • Published the Ring Appstore Marketing Guidelines, bringing the marketing guidelines online. Covers Ring Appstore badge placement, safe zones and sizing, and the six changes you must not make to the badge artwork. Documents approved compatibility and availability phrasing, the copy dos and don'ts that hold up review, requirements for Ring device imagery and video, where to download official badge assets, and the press release approvals process.

  • Documented the approvals process. Press releases and video that describe your Ring integration go to the Ring PR team 10–12 business days before your intended publication date. No approval is needed when the only Ring mention is that the Ring Appstore is one of the platforms carrying your app.

  • Added a Marketing Your App section to the Publish guide at the point where a rollout completes. Linked the guidelines from the Branding Requirements section of the Program Requirements, which previously referred to them with no way to reach them, and from Certify Your Ring Application.

August 28, 2026

Documentation changes

  • Published the Reports for Your Ring App guide, documenting the weekly metrics report in the Ring Developer Portal. Covers how to open the report from the app navigation, the four-column layout of Last Week, This Week, and YTD values, all 12 metrics grouped by engagement, trials, subscriptions, and revenue, selecting an earlier reporting week, and downloading the report as a PDF. Also documents the reading conventions that are easy to get wrong: YTD is year to date as of the selected week rather than as of today, an em dash means no value rather than zero, and reports are available for public apps only.

  • Cross-linked the new report guide with Customer Lifecycle Analytics for Your App to separate the metrics Ring generates for you from the events you instrument in your own app.

August 24, 2026

Early access

Dynamic scopes — When creating an app, you now select the specific Ring API scopes it requires (Cameras and Doorbells, Sensors, Chimes) instead of receiving a fixed standard set. Account and Lifecycle event scopes are always granted. Apps using dynamic scopes can only be published once dynamic scopes reach general availability for Ring customers. See Configure Phase.

Sensor support — Ring sensors are now documented as a device family. Sensors are devices resources, so the device endpoints you already use work unchanged, though a sensor may have no camera and no media endpoints. Available through the Ring Developer Early Access Program and subject to change before general availability. See Sensors.

Documentation changes

  • Added the Sensors section covering discovery, identification, common telemetry, configuration, and event delivery, plus device pages for Contact Sensors, Flood/Freeze Sensor, Indoor Temperature/Humidity Sensor, and Indoor Air Quality Monitor.

  • Documented four sensor integration constraints: device type cannot be inferred from capabilities, since capability keys are shared across device families and sensors sharing a signal share event types; no battery webhook is delivered at any level, so monitor battery_status.percentage from status; device_online acts as a heartbeat rather than a connectivity transition, and device_offline lags the actual loss of connectivity; and configurations returns camera-oriented attributes that are null for sensors.

  • Updated the Configure Phase guide for the revised app creation flow: the new App type selection (public or private), the API scopes section replacing the read-only API Access summary, the Confirm to create new app dialog that captures compliance agreement, and per-app-type App information — four tabs for public apps, name and optional icon for private.

  • Updated Account linking with the Default Redirect URL, optional iOS App Link and Android App Link fields, and the Copy from staging settings option on the Production tab.

August 20, 2026

Documentation changes

  • Added the Multi-Camera Devices section, documenting devices that contain more than one camera module, such as the Ring Elite lineup. These report as a single device, and each module is a component identified by a component_id read from the components object in the device's capabilities. Covers detection, module ordering for panoramic composition, targeting, and default behavior.

  • Documented per-camera targeting across the endpoints. Capabilities, Configurations, Live Video, and RTSP Live Video Streaming accept an optional component_id query parameter. Media Clips and Image Snapshots instead take a components array in the request body, holding exactly one component_id — one request per module. Motion Detection webhooks carry a component_ids array, and Event History notes that history is device-level with no component_id filter.

August 13, 2026

Documentation changes

  • Added the Partner-Initiated OAuth 2.0 Account Linking section, documenting a second account linking method that lets partners start the linking flow from their own app or platform rather than from Ring AppStore. It uses the standard OAuth 2.0 authorization code flow with PKCE (S256), so there is no HMAC nonce and no unclaimed token pool — the Bearer token is proof of possession. Covers requesting access, Developer Portal configuration, a six-step implementation guide from PKCE generation through the first API call, token management, webhook notifications, pausing and removing integrations, security requirements, an implementation checklist, an error handling reference, and an FAQ. Available by invitation only.

July 21, 2026

Documentation changes

  • Added the Private Use Apps section, documenting the new Private Apps track in the Ring Developer Portal. Private apps bypass certification and Appstore listing, support up to 5 allowlisted Ring accounts, and are distributed through the Ring App Store with a private badge. Covers the Public Apps / Private Apps tab selection, app creation, the Configure and Build phases, and the new Connect phase for allowlisting accounts.

  • Added the RTSP Live Video Streaming section, documenting the Ring RTSP Bridge (RTSPS over TCP-interleaved transport) as an alternative to WHEP for server-side integrations and standard RTSP clients such as GStreamer and FFmpeg. Covers authentication, session flow, client examples, error handling, and best practices.

June 16, 2026

Documentation changes

  • Published the Customer Lifecycle Analytics for Ring Appstore Apps guide. This guide covers how to instrument your app to track the full customer journey — from account linking through subscription conversion — including recommended events, key metrics, and dashboard patterns for account linking funnels, subscription tracking, feature engagement, webhook health, and error tracking.

June 8, 2026

API changes

Watermark added to Live Video, Media Clips, and Image Snapshots — All media content delivered through the Ring Partner API now includes a mandatory visible watermark overlay containing the Ring logo (top-left), Device ID, App Name, and timestamp (top-right). This applies to Live Video Streaming, Media Clip downloads, and Image Snapshot downloads. The watermark is applied server-side and cannot be removed. No changes are required to existing API request parameters. Ring developers using AI/ML models to process media content may need to retrain models to account for the watermark overlay.

May 28, 2026

Developers Playground

  • Released the Playground, a sandbox to test Ring device, media, and account APIs in real-time without creating an app, completing account linking, or having an active Ring subscription. These steps are still required for production deployment.

  • Added one-click OAuth token generation (valid 30 minutes), an interactive API explorer with curl commands and live JSON responses, and quick-start links to the Ring MCP server, GitHub sample app, and getting-started guides.

  • Added live view event simulation for Package, Vehicle, and Motion event types with full WebRTC/WHEP session workflow and live view streaming.

April 22, 2025

Documentation changes

  • Published the Your App Design Guide for Ring Customer Experiences. This guide provides design guidelines and user experience best practices for partner apps integrating with Ring devices, covering account setup, device display, subscription handling, accessibility (WCAG 2.2 Level AA), and proactive customer engagement.

  • Added the email pre-fill and deferred verification pattern for reducing account linking churn. Partners can use the Users API to pre-populate the email field and skip verification when the signup email matches the Ring email.

  • Added the device configuration guidance pattern for directing customers to the Ring app when read-only settings such as Smart Alerts or Motion Zones affect partner app functionality.

  • Added a design checklist summarizing all UX requirements for partner app certification readiness.

April 21, 2025

General availability

The Ring Appstore API is now generally available. Partners can register, build, test, certify, and publish applications that integrate with Ring devices.

API changes

  • Released the Ring Partner API with OAuth 2.0 account linking, device discovery, capabilities, status, configurations, locations, and Users API endpoints. All endpoints follow the JSON:API specification with Bearer token authentication.

  • Released webhook event delivery with HMAC-SHA256 signature verification for real-time notifications including motion_detected, button_press, device_added, device_removed, device_online, device_offline, app_integration_added, app_integration_removed, subscription_activated, and subscription_deactivated events.

  • Released live video streaming using WebRTC/WHEP and RTSP protocols, the Media Clips API for downloading historical MP4 recordings, the Image Snapshots API for JPEG/PNG snapshots, and the Event History API for retrieving historical device events.

  • Released the Subscriptions Query API for retrieving customer subscription and free trial status, including plan details, activation dates, and expiration dates.

Documentation changes

Follow us:
amazon_developer_logo

© 2010-2026, Amazon.com, Inc. or its affiliates. All Rights Reserved.

Terms

Amazon Developer Blog

Contact Us