Create an Outlook.com email draft
Input
to requiredRecipient email address, e.g. [email protected]
body optionalPlain text body of the draft.
subject optionalSubject line of the draft.
Output
to requiredsubject requiredverified requiredTrue only when the saved draft was found by reopening Drafts and matching caller-supplied text. Never inferred from the composer, and never satisfied by an unrelated existing draft.
body optionaldraftId optionalRow id of the saved draft in Drafts, usable with get_email. Null when no matching row was found.
composed optionalWhat the composer itself held just before saving. Distinguishes a fill failure from a save failure.
unverifiedReason optionalWhy verification did not succeed, when it did not.
FAQ
Move an Outlook.com email to a folder
Move one Outlook.com (outlook.live.com) message to another folder by its id (from list_emails). Any folder in your folder list can be the destination, named exactly as it appears there. The move is confirmed on both sides — the message must have left the source and arrived in the destination — and because Outlook gives a message a new id in its new folder, that new id is returned for any follow-up call. Taking a message out of Junk Email is confirmed automatically without accepting Outlook's offer to stop future mail from that sender being treated as junk. Drafts are not supported.
Delete an Outlook.com email
Delete one received Outlook.com (outlook.live.com) message by its id (from list_emails). Confirms the message is actually gone and that exactly one message was removed, rather than assuming the action worked, and then reports whether it is still recoverable: deleting from an ordinary folder files the message in Deleted Items, while deleting from Junk Email destroys it outright. When it is recoverable the id it now has in Deleted Items is returned. Drafts are not supported, because selecting a draft opens it in the composer. Deleting from Deleted Items is also refused, since that is permanent and Outlook gates it behind a confirmation dialog.
Send an Outlook.com email
Send an email from Outlook.com (outlook.live.com) to a recipient, with a subject and body. Confirms the message actually left by finding it in Sent Items, rather than assuming the Send click worked.