---
title: "requestAuthorization(options:completionHandler:)"
framework: usernotifications
role: symbol
role_heading: Instance Method
path: "usernotifications/unusernotificationcenter/requestauthorization(options:completionhandler:)"
---

# requestAuthorization(options:completionHandler:)

Requests a person’s authorization to allow local and remote notifications for your app.

## Declaration

```swift
func requestAuthorization(options: UNAuthorizationOptions = [], completionHandler: @escaping @Sendable (Bool, (any Error)?) -> Void)
```

```swift
func requestAuthorization(options: UNAuthorizationOptions = []) async throws -> Bool
```

## 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 doc://com.apple.usernotifications/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:

## Mentioned in

Asking permission to use notifications

## Discussion

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: func requestAuthorization(options: UNAuthorizationOptions = []) async throws -> Bool For information about concurrency and asynchronous code in Swift, see Calling Objective-C APIs Asynchronously. 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 Asking permission to use notifications. 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:) method to determine what interactions are allowed for your app. 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. }

## See Also

### Requesting authorization

- [UNAuthorizationOptions](usernotifications/unauthorizationoptions.md)