<!--
{
  "availability" : [
    "iOS: 18.2.0 -",
    "iPadOS: 18.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Messages",
  "identifier" : "/documentation/Messages/MSCriticalSMSMessenger/requestAuthorization(for:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Messages"
    ],
    "preciseIdentifier" : "s:8Messages22MSCriticalSMSMessengerC20requestAuthorization3forSDyAA11MSRecipientVAA0b9MessagingE6StatusOGSayAGG_tYaKF"
  },
  "title" : "requestAuthorization(for:)"
}
-->

# requestAuthorization(for:)

Requests a person’s authorization to send messages to the provided recipients.

```
func requestAuthorization(for recipients: [MSRecipient]) async throws -> [MSRecipient : MSCriticalMessagingAuthorizationStatus]
```

## Parameters

`recipients`

The full set of [`MSRecipient`](/documentation/Messages/MSRecipient) structures the app requests access for. A non-conforming array throws an [`MSCriticalMessagingError.invalidAuthenticationRequest`](/documentation/Messages/MSCriticalMessagingError/invalidAuthenticationRequest) error.

## Discussion

Request someone’s authorization to be able to send critical messages from
this app. The framework shows an authorization alert for each recipient,
one at a time, up to the maximum of recipients the framework allows, which you
can determine by examining the constant [`maximumCriticalMessagingRecipients`](/documentation/Messages/MSCriticalSMSMessenger/maximumCriticalMessagingRecipients).

You can call this method multiple times with the same
or different recipients, the framework displays the
permission alert with the latest block of recipients. When you call
this method subsequent times, all previous recipients move
automatically to [`MSCriticalMessagingError.notAuthorized`](/documentation/Messages/MSCriticalMessagingError/notAuthorized) status.

Upon success, the method returns a dictionary that maps recipients to their
corresponding authorization status.

---

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)