Skip to content

Instantly share code, notes, and snippets.

@miwebguy
Last active July 3, 2025 09:44
Show Gist options
  • Save miwebguy/2e805e343e0d434f06f2194b92b925d8 to your computer and use it in GitHub Desktop.
Save miwebguy/2e805e343e0d434f06f2194b92b925d8 to your computer and use it in GitHub Desktop.
URLs for linking to specific tasks in Outlook Web Access (deeplinks)

Outlook Web Access Compose Urls

blogs.msdn.microsoft.com/carloshm/2016/01/16/how-to-compose-a-new-message-or-event-and-populate-fields-in-office365/

Compose New Message (Mail): (updated 2021)

https://outlook.office.com/mail/deeplink/compose

Compose Mail Parameters

  • subject
  • body
  • to

Compose Mail Example:

https://outlook.office.com/mail/deeplink/[email protected]&subject=Customer+Service+Request&body=Add+Your+Request+here

New Calendar Event (updated 2021)

https://outlook.office.com/calendar/deeplink/compose

New Calendar Event Parameters

  • subject
  • body
  • location
  • startdt 2016-02-29T19:00:00
  • enddt 2016-03-01T00:00:05

New Calendar Event Example:

https://outlook.office.com/calendar/deeplink/compose?&subject=Sushi%20Training&location=Convention%20Center&startdt=2016-02-29T19%3A00%3A00&enddt=2016-03-01T00%3A00%3A05&body=Remember+to+bring+your+force!

Bonus: View Specific Outlook Inbox

https://outlook.office.com/mail/[email protected]/inbox

Remember that for more complex scenarios, you have available Outlook API, mail, calendar and more

Bonus Teams Chat link

https://teams.microsoft.com/l/chat/0/[email protected]

https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/build-and-test/deep-link-teams#deep-link-to-start-a-new-chat

@th91vi
Copy link

th91vi commented Nov 16, 2020

thanks for this gist. helped a lot 👍

@PPetky
Copy link

PPetky commented Jun 5, 2021

Thanks, it helped me a lot, but MS deleted
the blog entry of
https://blogs.msdn.microsoft.com/carloshm/2016/01/16/how-to-compose-a-new-message-or-event-and-populate-fields-in-office365/
is there any archive?

@miwebguy
Copy link
Author

miwebguy commented Jun 9, 2021

Thanks, it helped me a lot, but MS deleted
the blog entry of
https://blogs.msdn.microsoft.com/carloshm/2016/01/16/how-to-compose-a-new-message-or-event-and-populate-fields-in-office365/
is there any archive?

Nope, not even in the wayback machine.

@PPetky
Copy link

PPetky commented Sep 13, 2021

Hi all!
FYI, looks like https://outlook.office.com/owa/?path=/calendar/action/compose not working anymore

@miwebguy
Copy link
Author

@miwebguy
Copy link
Author

@miwebguy
Copy link
Author

(Still not finding official documentation)

@Terry-Hagan-BA
Copy link

Hi, doesn't seem to work on mobile, opens up the browser but just goes to the Inbox.

@robinmalik
Copy link

robinmalik commented Aug 19, 2022

Does anyone know if there's a way to construct a deeplink to a specific calendar? Or a resource calendar? Currently you have to select it manually from a dropdown, and the option only appears there if you've selected the calendar in the 'main' OWA view (potentially from one of many hundreds, if you're part of lots of MS Teams)

@MadsAnker
Copy link

Does anyone know of any official MS documentation regarding the https://outlook.office.com/mail/deeplink/compose endpoint?

@kadosknight
Copy link

Many sources use "calendar/0/deeplink/compose" but that doesn't work anymore, use "calendar/deeplink/compose" instead and it works!

@v-mspasybin-crestron
Copy link

Does anyone know if there's a way to construct a deeplink to a specific calendar? Or a resource calendar? Currently you have to select it manually from a dropdown, and the option only appears there if you've selected the calendar in the 'main' OWA view (potentially from one of many hundreds, if you're part of lots of MS Teams)

@robinmalik Did you figure out the answer? I also have such issue

@miwebguy
Copy link
Author

@bodograumann
Copy link

The mail example link should start the query string with ?.
https://outlook.office.com/mail/deeplink/[email protected]&subject=Customer+Service+Request&body=Add+Your+Request+here

Does anybody know a way to define the CC-recipients as well?

@miwebguy
Copy link
Author

Thanks @bodograuman. Updated.

the standard cc=and bcc= that gmail uses don't work, so I'm not sure if they're implemented.

@miwebguy
Copy link
Author

@PhoenixAlpha204
Copy link

PhoenixAlpha204 commented Jun 7, 2024

You can deeplink to the view of a calendar - Mail https://outlook.office.com/mail/[email protected]/ Calendar https://outlook.office.com/calendar/[email protected]/view/month

@miwebguy Is there a way to combine this with the "new event" deeplink? I.e. a link that creates an event in a specific calendar?

EDIT: nevermind, got it, it's https://outlook.office.com/calendar/[email protected]/deeplink/compose. The selected calendar says it's still my email address but that appears to be a visual bug, the title bar shows the correct calendar.

@hungchips
Copy link

hungchips commented Aug 24, 2024

Thanks a lot it still works in 2024_08_24. But does anyone know how to use something like BBCode/Hyperlink in Outlook's BodyDeepLink?

For example I want to have hyperlink: https://admin.com clickable when compose mail interface appears...

@MaximeDelarue
Copy link

has anyone find a way to pre-select category or color (url parameter)?

@adam-kramer
Copy link

adam-kramer commented Jan 14, 2025

Outlook Calendar Query String Params:
Looking at the script that extracts the Query String parameters from the url and reassigns the values to the form fields the following are available:

Key Value Type Notes
subject string
body string
startdt string ISO string split on (".") removing milliseconds and zulu reference e.g. '2025-01-14T22:43:41.248Z' -> '2025-01-14T22:43:41'
enddt string ISO string split on (".") removing milliseconds and zulu reference e.g. '2025-01-14T22:43:41.248Z' -> '2025-01-14T22:43:41'
allday boolean
location string
folderid string
reqresponse boolean
allowfw boolean
hideattn boolean
remindminsbeforestart number (minutes before)
freebusy 'free,busy,oof,workingelsewhere,nodata'

@codingwaysarg
Copy link

codingwaysarg commented Feb 24, 2025

Hi everyone. Thanks for sharing this gist. Is there any way to open calendar event creation but with a shared calendar selected by default? I've tried with calendarId, folderid, but nothing works.

Thanks

@codingwaysarg
Copy link

Hi everyone. Thanks for sharing this gist. Is there any way to open calendar event creation but with a shared calendar selected by default? I've tried with calendarId, folderid, but nothing works.

Thanks

I just realized that you have to URL encode the folder id.

@KlotzJesse
Copy link

KlotzJesse commented Mar 4, 2025

https://outlook.office.com/calendar/deeplink/compose

@codingwaysarg Did it work to select a shared calendar with folderId? Which ID do i need to take and URL encode?. Help would be MUCH appreciated.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment