Permissions

getPermissionsAsync()

Returns the current alarm capability state without prompting.

const permissions = await AlarmScheduler.getPermissionsAsync();

type AlarmPermissionResponse = {
  platform: 'android' | 'ios';
  status: 'authorized' | 'denied' | 'notDetermined' | 'unavailable' | 'unknown';
  canScheduleExactAlarms: boolean;
  canOpenSettings: boolean;
  canUseFullScreenIntent?: boolean;
  canPostNotifications?: boolean;
};

canScheduleExactAlarms is the field to branch on. On Android it reflects whether exact alarm scheduling is currently allowed. On iOS it is true only when AlarmKit is available and authorized.

canUseFullScreenIntent is Android 14+ only: the alarm still rings without it, but it surfaces as a heads-up notification instead of taking over a locked screen. canPostNotifications is the Android 13+ POST_NOTIFICATIONS grant. Both extra fields are true on older Android versions and on iOS.

requestPermissionsAsync()

Requests or opens the native permission surface where possible, then returns the same AlarmPermissionResponse.

const permissions = await AlarmScheduler.requestPermissionsAsync();

On Android 12+ this opens the exact alarm settings screen if exact alarms are not currently allowed. On iOS 26+ it requests AlarmKit authorization.

openAlarmSettingsAsync()

Opens the relevant alarm or app settings screen. Returns whether the open action was started.

const opened = await AlarmScheduler.openAlarmSettingsAsync();

openFullScreenIntentSettingsAsync()

Android 14+ only. Opens the per-app Full screen notifications settings screen.

const opened = await AlarmScheduler.openFullScreenIntentSettingsAsync();

Returns false on older Android versions, on iOS, on web, and when no matching settings activity exists.