# requestAuthorization(options:completionHandler:) Requests a person’s authorization to allow local and remote notifications for your app. ``` func requestAuthorization(options: UNAuthorizationOptions = [], completionHandler: @escaping @Sendable (Bool, (any Error)?) -> Void) ``` ## Parameters `options` The authorization options your app is requesting. You may combine the available constants to request authorization for multiple items. Request only the authorization options that you plan to use. For a list of possible values, see [`UNAuthorizationOptions`](/documentation/UserNotifications/UNAuthorizationOptions). `completionHandler` The block to execute asynchronously with the results. This block may execute on a background thread. The block has no return value and has the following parameters: - granted: A Boolean value indicating whether the person grants authorization. The value of this parameter is when the person grants authorization for one or more options. The value is when the person denies authorization or authorization is undetermined. Use [`getNotificationSettings(completionHandler:)`](/documentation/UserNotifications/UNUserNotificationCenter/getNotificationSettings(completionHandler:)) to check the authorization status. - error: An object containing error information or `nil` if no error occurs. ## Discussion > Important: > You can call this method from synchronous code using a completion handler, as shown on this page, or you can call it as an asynchronous method that has the following declaration: > > ```swift > func requestAuthorization(options: UNAuthorizationOptions = []) async throws -> Bool > ``` > > For information about concurrency and asynchronous code in Swift, see . If your app’s local or remote notifications involve user interactions, you must request authorization for the system to perform those interactions on your app’s behalf. Interactions include displaying an alert, playing a sound, or badging the app’s icon. > Note: > Always call this method before scheduling any local notifications and before registering with the Apple Push Notification service. Do this in a context that helps people understand why your app needs authorization, as described in . The first time your app calls the method, the system prompts the person to authorize the requested interactions. The person may grant or deny authorization, and the system stores the person’s response. Subsequent calls to this method don’t prompt the person again. After determining the authorization status, the user notification center object executes the block in the `completionHandler` parameter. Use that block to make any adjustments to your app’s behavior. For example, if the person denied authorization, you might notify a remote notification server not to send notifications to the user’s device. The person may change the interactions they allow at any time in system settings. Use the [`getNotificationSettings(completionHandler:)`](/documentation/UserNotifications/UNUserNotificationCenter/getNotificationSettings(completionHandler:)) method to determine what interactions are allowed for your app. ```swift let center = UNUserNotificationCenter.current() do { if try await center.requestAuthorization(options: [.badge, .sound, .alert]) == true { // You have authorization. } else { // You don't have authorization. } } catch { // Handle any errors. } ``` --- Copyright © 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)