<!--
{
  "availability" : [
    "iOS: 26.5.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AccessoryNotifications",
  "identifier" : "/documentation/AccessoryNotifications",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "Accessory Notifications"
    ],
    "preciseIdentifier" : "AccessoryNotifications"
  },
  "title" : "Accessory Notifications"
}
-->

# Accessory Notifications

Receive forwarded iOS system notifications on an accessory that you develop.

## Overview

The Accessory Notifications framework allows accessory companion apps to request notification forwarding from people, and receive notification content from the system through an extension model. People can choose to forward notifications from all apps, no apps, or a subset of apps on their device. Implement the extensions this framework calls into using <doc://com.apple.documentation/documentation/AccessoryTransportExtension>, which transfers notification content and responses to and from your accessory.

> Important: This framework supports iPhone only. You can develop and test an app that uses this framework on devices in any region. Customer installations of your app can only use the framework on devices located in the EU that are signed in with an Apple Account with an EU country or region.

## Forward iOS system notifications to an accessory

The framework prompts the person to allow notification forwarding when your accessory’s companion app calls [`requestForwarding(for:)`](/documentation/AccessoryNotifications/AccessoryNotificationCenter/requestForwarding(for:)). The method returns a [`ForwardingDecision`](/documentation/AccessoryNotifications/ForwardingDecision) that indicates the person’s choice. Check the current forwarding status for an accessory using [`forwardingStatus(for:)`](/documentation/AccessoryNotifications/AccessoryNotificationCenter/forwardingStatus(for:)), or present notification settings using [`presentSettings(for:scenePersistentIdentifier:)`](/documentation/AccessoryNotifications/AccessoryNotificationCenter/presentSettings(for:scenePersistentIdentifier:)).

When a person approves the prompt and the system is ready to forward a notification, the system calls [`NotificationsForwarding.AccessoryNotificationsHandler`](/documentation/AccessoryNotifications/NotificationsForwarding/AccessoryNotificationsHandler) in an <doc://com.apple.documentation/documentation/AccessoryTransportExtension/AccessoryDataProvider> extension you implement to curate the notification details specifically for your accessory. The [`AccessoryNotification`](/documentation/AccessoryNotifications/AccessoryNotification) contains the complete notification data, from which you curate the details your accessory needs. [`AlertingContext`](/documentation/AccessoryNotifications/AlertingContext) determines if your accessory alerts for the notification, and how that alert occurs.

## Respond to notifications

If someone interacts with the notification, such as tapping to dismiss it, or typing text in a quick reply, your accessory sends information back to the companion app using [`messageHandler(_:)`](/documentation/AccessoryNotifications/NotificationsForwarding/AccessoryNotificationsHandler/messageHandler(_:)). The [`NotificationResponse`](/documentation/AccessoryNotifications/NotificationResponse) structure details the reply and your app delivers it to the system by calling [`sendResponse(_:)`](/documentation/AccessoryNotifications/NotificationsForwarding/AccessoryNotificationsSession/sendResponse(_:)).

## Topics

### Authorization

[`AccessoryNotificationCenter`](/documentation/AccessoryNotifications/AccessoryNotificationCenter)

A class that asks a person for permission to forward notifications.

[`ForwardingDecision`](/documentation/AccessoryNotifications/ForwardingDecision)

Possible decisions in response to the notification forwarding permission prompt.

### Notification receipt

  <doc://com.apple.documentation/documentation/AccessoryTransportExtension/receiving-ios-notifications-on-an-accessory>

[`NotificationsForwarding`](/documentation/AccessoryNotifications/NotificationsForwarding)

A class for handling notification forwarding in your accessory’s data provider extension.

[`AccessoryNotificationsHandler`](/documentation/AccessoryNotifications/NotificationsForwarding/AccessoryNotificationsHandler)

A protocol that defines methods for handling notification life cycle events in your extension.

[`Session`](/documentation/AccessoryNotifications/NotificationsForwarding/Session)

A session object that facilitates bidirectional communication between the system and your extension.

### Data curation and alerting

[`AccessoryNotification`](/documentation/AccessoryNotifications/AccessoryNotification)

A structure that contains the details of a notification that iOS provides to your accessory.

[`AlertingContext`](/documentation/AccessoryNotifications/AlertingContext)

A structure that provides guidance for how to alert for a notification.

### Interactive support

[Responding to forwarded notifications](/documentation/AccessoryNotifications/responding-to-forwarded-notifications)

Enable people to interact with notifications on your accessory and convey their responses to iOS.

[`NotificationResponse`](/documentation/AccessoryNotifications/NotificationResponse)

A structure that represents a person’s response to a notification.

### Errors

[`AccessoryError`](/documentation/AccessoryNotifications/AccessoryError)

Errors the Accessory Notifications framework can throw.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)