# schedule(id:configuration:) Schedules a new alarm. ``` func schedule(id: Alarm.ID, configuration: AlarmManager.AlarmConfiguration) async throws -> Alarm where Metadata : AlarmMetadata ``` ## Parameters `id` The alarm’s identifier. `configuration` The configuration for the new alarm. ## Discussion If scheduling a new alarm is successful, the function returns the [`Alarm`](/documentation/AlarmKit/Alarm) structure. If you provide a [`countdownDuration`](/documentation/AlarmKit/Alarm/countdownDuration-swift.property), the system shows a countdown UI for the specified duration before the alarm alerts. If you provide a `schedule`, the alarm alerts at the scheduled time. If you provide both a `countdownDuration` and a [`schedule`](/documentation/AlarmKit/Alarm/schedule-swift.property), the system shows a countdown UI before the alarm alerts, possibly on a repeating schedule. Define the ID to encode it into your intent. --- Copyright © 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)