# Titanium.App.iOS.UserNotificationAction

> An action the user selects in response to an interactive notification.

- Source: https://titaniumsdk.com/docs/sdk/13.3.1/Titanium.App.iOS.UserNotificationAction
- Titanium SDK version: 13.3.1
- Kind: proxy
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.4.0
- Extends: Titanium.Proxy
- Inheritance: Titanium.Proxy

To create a notification action, use the [Titanium.App.iOS.createUserNotificationAction](https://titaniumsdk.com/docs/sdk/Titanium.App.iOS.md#createUserNotificationAction) method.

An notification action represents an option a user selects in response to an interactive
notification.  The notification action is represented as a button in the application UI.

## Properties

### activationMode

- Type: Number
- Platforms: iPhone, iPad, macOS

Selects how to activate the application.

Set to `Titanium.App.iOS.USER_NOTIFICATION_ACTIVATION_MODE_BACKGROUND` to activate the application in the
background to respond to the action unless the application is already in the foreground.

Set to `Titanium.App.iOS.USER_NOTIFICATION_ACTIVATION_MODE_FOREGROUND` to launch the application in the
foreground to respond to the action. These actions won't be displayed on Apple Watch.

Accepts: `Titanium.App.iOS.USER_NOTIFICATION_ACTIVATION_MODE_BACKGROUND`, `Titanium.App.iOS.USER_NOTIFICATION_ACTIVATION_MODE_FOREGROUND`

### authenticationRequired

- Type: Boolean
- Platforms: iPhone, iPad, macOS

Set to true if the action requires the device to be unlocked. On the Apple Watch actions never require authentication.

### behavior

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.1.0
- Default: `<Titanium.App.iOS.USER_NOTIFICATION_BEHAVIOR_DEFAULT>`

Custom behavior the user notification supports.

Accepts: `Titanium.App.iOS.USER_NOTIFICATION_BEHAVIOR_DEFAULT`, `Titanium.App.iOS.USER_NOTIFICATION_BEHAVIOR_TEXTINPUT`

### destructive

- Type: Boolean
- Platforms: iPhone, iPad, macOS

Set to true if the action causes destructive behavior to the user's data or the application.

The action appears red in the locked screen and notification center instead of the
default color.

### identifier

- Type: String
- Platforms: iPhone, iPad, macOS

Identifier for this action. Used to identify the action the user pressed.

### title

- Type: String
- Platforms: iPhone, iPad, macOS

Title of the button displayed in the notification.

## Inherited members

1 members are inherited. Each is documented on the type that declares it.

- [Titanium.Proxy](https://titaniumsdk.com/docs/sdk/13.3.1/Titanium.Proxy.md): `apiName`

---

- This corpus documents Titanium SDK 13.4.1. Anything here that does not name a version describes 13.4.1.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.