# Mail Make your email app’s actions available to Apple Intelligence and Siri by adopting schemas for common email actions. ## Discussion The `.mail` domain defines app schemas that provide a structured representation for common email actions and content. Apply schemas in the `.mail` domain to make your app’s email functionality available to Apple Intelligence and Siri. Each schema defines the requirements for intents, parameters, and results so people get a consistent experience across email apps. For example, a person can compose an email on different apps that support the [`createDraft`](/documentation/AppIntents/AppSchema/MailIntent/createDraft) schema with the same phrases. The following table maps example phrases that apply to each schema. Your app needs to support all of these schemas when it supports any one of them. |Mail intent schemas |Example phrases | |----------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------| |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/createDraft``|“Compose a mail.” or “Write an email to example@example.com about photos from team dinner.”| |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/updateDraft``|“Add example@example.com to recipients.” or “Set subject to coffee session.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/saveDraft`` |“Draft this email for later.” or “Save it.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/openDraft`` |“Open the draft email to John and James.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/deleteDraft``|“Delete this draft.” or “Trash my most recent draft.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/sendDraft`` |“Send this email.” or “Send this email tomorrow at 9 PM.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/openMessage``|“Open the email about team offsite instructions.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/replyMail`` |“Reply to an email.” or “Reply to mail thread with my manager.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/forwardMail``|“Forward an email.” or “Forward the email about the baseball schedule to John Appleseed.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/updateMail`` |“Mark this email as read.” or “Flag this email.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/archiveMail``|“Archive book club emails.” or “Archive emails from Nancy.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MailIntent/deleteMail`` |“Delete emails from Julian.” or “Trash all mail messages from Example Store.” | At build time, Xcode validates whether your app implements all the schemas in the group. > Tip: Xcode generates a template implementation when you type `mail_` and select a schema from the suggestions list. For more information about making your app’s actions available to Apple Intelligence and Siri, see [Apple Intelligence and Siri AI](/documentation/AppIntents/apple-intelligence-and-siri-ai). ## Topics ### Actions [`archiveMail`](/documentation/AppIntents/AppSchema/MailIntent/archiveMail) An intent schema that archives one or more email messages. [`createDraft`](/documentation/AppIntents/AppSchema/MailIntent/createDraft) An intent schema that opens an email composer to draft an email. [`deleteDraft`](/documentation/AppIntents/AppSchema/MailIntent/deleteDraft) An intent schema that deletes one or more email drafts. [`deleteMail`](/documentation/AppIntents/AppSchema/MailIntent/deleteMail) An intent schema that deletes one or more email messages. [`forwardMail`](/documentation/AppIntents/AppSchema/MailIntent/forwardMail) An intent schema that opens an email composer to forward an email. [`openDraft`](/documentation/AppIntents/AppSchema/MailIntent/openDraft) An intent schema that opens an email draft. [`openMessage`](/documentation/AppIntents/AppSchema/MailIntent/openMessage) An intent schema that opens an email message. [`replyMail`](/documentation/AppIntents/AppSchema/MailIntent/replyMail) An intent schema that opens an email composer to reply to an email. [`saveDraft`](/documentation/AppIntents/AppSchema/MailIntent/saveDraft) An intent schema that saves an email draft. [`sendDraft`](/documentation/AppIntents/AppSchema/MailIntent/sendDraft) An intent schema that sends an email draft or schedules it to be sent later. [`updateDraft`](/documentation/AppIntents/AppSchema/MailIntent/updateDraft) An intent schema that makes updates to an email draft. [`updateMail`](/documentation/AppIntents/AppSchema/MailIntent/updateMail) An intent schema that makes updates to one or more existing email messages by modifying the status, flags, and location. [`MailIntent`](/documentation/AppIntents/AppSchema/MailIntent) Identifies intent schemas in the mail domain. ### Content and parameter types [`account`](/documentation/AppIntents/AppSchema/MailEntity/account) An entity schema for an account. [`draft`](/documentation/AppIntents/AppSchema/MailEntity/draft) An entity schema for a draft. [`mailbox`](/documentation/AppIntents/AppSchema/MailEntity/mailbox) An entity schema for a mailbox. [`message`](/documentation/AppIntents/AppSchema/MailEntity/message) An entity schema for a message. [`thread`](/documentation/AppIntents/AppSchema/MailEntity/thread) An entity schema for a thread. [`MailEntity`](/documentation/AppIntents/AppSchema/MailEntity) Identifies entity schemas in the mail domain. --- 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)