<!--
{
  "documentType" : "article",
  "framework" : "SiriKit",
  "identifier" : "/documentation/SiriKit/requesting-authorization-to-use-siri",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Requesting Authorization to Use Siri"
}
-->

# Requesting Authorization to Use Siri

Request permission from the user for Siri and Maps to communicate with your app or Intents app extension.

## Discussion

Siri can’t interact with your app or app extension until the user grants permission. Maps only interacts with your app extension, but as with Siri, only after the user authorizes it to do so. Request authorization from your iOS app, whether you’re handling intents in an app extension or in your app. When the user approves an authorization request from your iOS app, this grants permission for your iOS app, its Intents app extension, and your watchOS app.

> Note:
> You don’t need to request authorization if your app only supports actions in the Shortcuts app.

### Configure Your App Target

First, enable the Siri capability for your iOS app or WatchKit extension for authorization to succeed. For information about how to enable the Siri capability, see <doc://com.apple.documentation/documentation/SiriKit/creating-an-intents-app-extension>.

Next, configure your `Info.plist` file. Include the <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/NSSiriUsageDescription> key in your iOS appʼs `Info.plist` file. The value for this key is a string that describes what information your app shares with SiriKit. For example, a workout app might set the value to the string *Workout information will be sent to Siri*. This key is a requirement.

### Request User Authorization

Call the [`requestSiriAuthorization(_:)`](/documentation/Intents/INPreferences/requestSiriAuthorization(_:)) class method of [`INPreferences`](/documentation/Intents/INPreferences) at some point during your iOS app’s execution.

Your app’s authorization status is [`INSiriAuthorizationStatus.notDetermined`](/documentation/Intents/INSiriAuthorizationStatus/notDetermined) until the user authorizes or denies access. When your app requests authorization and its status is undetermined, the system prompts the user to authorize your app. The alert includes the usage description string you provided in the <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/NSSiriUsageDescription> key of your app’s `Info.plist` file.

The user can approve or deny your app’s request for authorization, and can change your app’s authorization status later in the Settings app. The system remembers your app’s authorization status so that subsequent calls to the [`requestSiriAuthorization(_:)`](/documentation/Intents/INPreferences/requestSiriAuthorization(_:)) method don’t prompt the user again.

> Note:
> Siri and Maps may assist in authorizing your app or Intents app extension when the user first tries to use an intent you support. Specifically, if the user interacts with your app or app extension and your app’s authorization status isn’t yet determined, Maps requests authorization automatically on your extension’s behalf.

---

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)