> For the complete documentation index, see [llms.txt](https://telephony.shounakmulay.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://telephony.shounakmulay.dev/permissions.md).

# Permissions

{% hint style="danger" %}
**Telephony will only request those permission that are listed in the *****`AndroidManifest.xml`*****.**
{% endhint %}

Following necessary permissions are also listed at the top of every page. 

| Use Case                                                                  | Permission        |
| ------------------------------------------------------------------------- | ----------------- |
| [Sending An SMS](/sending-an-sms.md)                                      | **`SEND_SMS`**    |
| [Query SMS](/query-sms.md), [Query Conversation](/query-conversations.md) | **`READ_SMS`**    |
| [Listen Incoming SMS](/listen-incoming-sms.md)                            | **`RECEIVE_SMS`** |

### List Necessary Permissions

List the permission necessary for your use cases in your app's `AndroidManifest.xml`

{% code title="AndroidManifest.xml" %}

```markup
<uses-permission android:name="android.permission.SEND_SMS"/>
<uses-permission android:name="android.permission.READ_SMS"/>
<uses-permission android:name="android.permission.RECEIVE_SMS"/>
```

{% endcode %}

{% hint style="warning" %}
**Although this plugin will check and ask for permissions at runtime, it is advisable to&#x20;*****manually ask for permissions*****&#x20;before calling any other functions.**
{% endhint %}

### Request Phone and SMS Permissions

```dart
Telephony telephony = Telephony.instance;

bool permissionsGranted = await telephony.requestPhoneAndSmsPermissions;
```

### Request SMS Permissions

```dart
bool permissionsGranted = await telephony.requestSmsPermissions;
```

### Request Phone Permissions

```dart
bool permissionsGranted = await telephony.requestPhonePermissions;
```