Skip to main content

outlook mail send

Sends an email

Usage​

m365 outlook mail send [options]

Options​

-s, --subject <subject>

Email subject.

-t, --to <to>

Comma-separated list of emails to send the message to.

--cc [cc]

Comma-separated list of CC recipients for the message.

--bcc [bcc]

Comma-separated list of BCC recipients for the message.

--sender [sender]

Optional upn or user id to specify what account to send the message from. Also see the remarks section.

-m, --mailbox [mailbox]

Specify this option to send the email on behalf of another mailbox, for example a shared mailbox, group or distribution list. The sender needs to be a delegate on the specified mailbox. Also see the remarks section.

--bodyContents <bodyContents>

String containing the body of the email to send.

--bodyContentType [bodyContentType]

Type of the body content. Available options: Text, HTML. Default is Text.

--importance [importance]

The importance of the message. Available options: low, normal, or high. Default is normal.

--attachment [attachment]

Path to the file that will be added as attachment to the email. This option can be used multiple times to attach multiple attachments.

--saveToSentItems [saveToSentItems]

Save email in the sent items folder. Default true.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

Attachments​

When using the attachment option, note that the total size of all attachment files cannot exceed 3 MB.

If you are connected using app only authentication​

  • Always specify a user id or upn in the --sender option. The email will be sent as if it came from the specified user, and can optionally be saved in the sent folder of that user account.
  • You can optionally also specify the --mailbox option to send mail on behalf of a shared mailbox, group or distribution list. The account used in the --sender option, needs to have 'Send on behalf of' permissions on the mailbox in question.
info

You need Mail.Send application permissions on the Microsoft Graph to be able to send mails using an application identity.

If you are connected with a regular user account​

  • Specify the --mailbox option if you want to send an email on behalf of another mailbox. This can be a shared mailbox, group or distribution list. It will be visible in the email that the email was sent by you. You need to be assigned Send on behalf of permissions on the mailbox in question.
  • You can specify the --sender option if you want to send an email as if you were the other user. The sent email can optionally be saved in the sent folder of that user account. You'll need Read and manage (Full Access) permissions on the mailbox of the other user. You can combine the --sender and --mailbox options to let the other user send a mail on behalf of the specified mailbox.
info

You need at least Mail.Send delegated permissions on the Microsoft Graph to be able to send emails. When specifying another user as sender, you'll need Mail.Send.Shared permissions.

Examples​

Send a text email to the specified email address

m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site"

Send an HTML email to the specified email addresses

m365 outlook mail send --to "chris@contoso.com,brian@contoso.com" --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the <a href='https://contoso.sharepoint.com/sites/marketing'>team site</a>" --bodyContentType HTML

Send an HTML email to the specified email address loading email contents from a file on disk

m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents @email.html --bodyContentType HTML

Send a text email to the specified email address. Don't store the email in sent items

m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --saveToSentItems false

Send an email on behalf of a shared mailbox using the signed in user

m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --mailbox sales@contoso.com

Send an email as another user

m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --sender svc_project@contoso.com

Send an email as another user, on behalf of a shared mailbox

m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --sender svc_project@contoso.com --mailbox sales@contoso.com

Send an email with cc and bcc recipients marked as important

m365 outlook mail send --to chris@contoso.com --cc claire@contoso.com --bcc randy@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --importance high

Send an email with multiple attachments

m365 outlook mail send --to chris@contoso.com --subject "Monthly reports" --bodyContents "Here are the reports of this month." --attachment "C:/Reports/File1.jpg" --attachment "C:/Reports/File2.docx" --attachment "C:/Reports/File3.xlsx"

Response​

The command won't return a response on success.

CTRL + M