Propose New Time—a new feature for Outlook Web App in Office 365 ... | outlook office com owaoutlook office com owa
Last Updated: 10/20/2017
["1164"]
Email Rendering | outlook office com owaAPI Version: v1.0 v2.0 beta
outlookrestapibeta
This affidavit covers the API for affair rooms, assorted accident locations, agenda sharing, and forwarding and cancelling contest which are in preview. Examination appearance are accountable to change above-mentioned to finalization, and may breach cipher that uses them. Because of this, in accepted you should use alone a assembly adaptation of an API in your assembly code. If available, v2.0 is currently the adopted version.
outlookrestapibeta
outlookrestapiv1
outlookrestapiv1
Applies to: Exchange Online | Appointment 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com
The Agenda API provides admission to events, calendar, and agenda accumulation abstracts anchored by Azure Active Directory on Appointment 365, and to agnate abstracts in Microsoft accounts accurately in these domains: Hotmail.com, Live.com, MSN.com, Outlook.com, and Passport.com.
Note
outlookrestapibeta
Not absorbed in the beta adaptation of the API? Use the ascendancy at the top adapted bend and baddest the adaptation you want.
outlookrestapibeta
outlookrestapiv2
Not absorbed in v2.0 of the API? Use the ascendancy at the top adapted and baddest the adaptation you want.
outlookrestapiv2
outlookrestapiv1
Not absorbed in v1.0 of the API? Use the ascendancy at the top adapted and baddest the adaptation you want.
outlookrestapiv1
Event operations An accident represents an arrangement or affair on the user's calendar. An accident can be a alternation adept (for alternating events), an occurrence, a distinct instance, or an exception.
outlookrestapibeta
Get contest | Accompany contest | Acquisition affair times | Get affair apartment | Actualize contest | Update contest | Respond to contest | Advanced contest (preview) | Annul contest | Abolish contest (preview) |
Get accessories | Actualize accessories | Annul accessories | Get reminders | Snooze reminders] | Dismiss reminders
outlookrestapibeta
outlookrestapiv2
Get contest | Accompany contest | Acquisition affair times | Actualize contest | Update contest | Respond to contest | Annul contest | Get accessories | Actualize accessories | Annul accessories | Get reminders | Snooze reminders] | Dismiss reminders
outlookrestapiv2
outlookrestapiv1
Get contest | Accompany contest | Actualize contest | Update contest | Respond to contest | Annul contest | Get accessories | Actualize accessories | Annul accessories | Get reminders | Snooze reminders] | Dismiss reminders
outlookrestapiv1
Calendar operations A agenda serves as a alembic for events. A user can acquire assorted calendars. In Appointment 365, anniversary agenda can be assigned to a agenda group.
Get calendars | Actualize calendars | Update calendars | Annul calendars
Calendar accumulation operations Agenda groups are a way to adapt assorted calendars. Users can add assorted calendars into a distinct agenda accumulation in Angle or Angle Web App. This makes it easier for users to bound appearance all calendars aural the group.
Note Outlook.com supports alone the absence agenda accumulation which is attainable by the ../me/calendars shortcut. You cannot annul that agenda group, or actualize addition agenda group.
Get agenda groups | Actualize agenda groups | Update agenda groups | Annul agenda groups
See also:
REST API accident ability | REST API agenda ability | REST API agenda accumulation resource
Like added Angle REST API, for every appeal to the Agenda API, you should accommodate a accurate admission token. Accepting an admission badge requires you to acquire registered and articular your app, and acquired the adapted authorization. You can acquisition out added about some automated allotment and allotment options for you. Keep this in apperception as you advance with the specific operations in the Agenda API.
Scopes to admission aggregate calendars
Office 365 and Outlook.com calendars abutment sharing. A user who created a agenda can allotment the agenda with added users. The afterward scopes are adapted to admission a agenda that has been aggregate with that user:
The Agenda REST API is accurate in all versions of the Angle REST API. The functionality may adapt depending on the specific version.
The Agenda API requests are consistently performed on annual of the accepted user.
See Use the Angle REST API for added advice accepted to all subsets of the Angle REST API.
Get an accident accumulating or an event.
outlookrestapibeta
An accident anatomy can be in either argument or HTML.
You can use the Prefer: outlook.body-content-type attack to specify the adapted architecture alternate in the Anatomy acreage in a GET request:
If you specify either header, the acknowledgment will accommodate the agnate Preference-Applied attack as confirmation:
All operations that get agenda contest can use the Prefer: outlook.timezone HTTP attack to specify the time area for alpha and end times in the response. For example, the afterward Prefer: outlook.timezone attack sets the alpha and end times in the acknowledgment to Eastern Standard Time.
If you do not specify the Prefer: outlook.timezone attack the alpha and end times in the acknowledgment are alternate in UTC.
You can use the OriginalStartTimeZone and OriginalEndTimeZone backdrop on the Accident ability to acquisition out the time area acclimated back the accident was created.
outlookrestapibeta
outlookrestapiv2
An accident anatomy can be in either argument or HTML.
You can use the Prefer: outlook.body-content-type attack to specify the adapted architecture alternate in the Anatomy acreage in a GET request:
If you specify either header, the acknowledgment will accommodate the agnate Preference-Applied attack as confirmation:
All operations that get agenda contest can use the Prefer: outlook.timezone HTTP attack to specify the time area for alpha and end times in the response. For example, the afterward Prefer: outlook.timezone attack sets the alpha and end times in the acknowledgment to Eastern Standard Time.
If you do not specify the Prefer: outlook.timezone attack the alpha and end times in the acknowledgment are alternate in UTC. See this annual for the accurate time area names.
You can use the OriginalStartTimeZone and OriginalEndTimeZone backdrop on the Accident ability to acquisition out the time area acclimated back the accident was created.
outlookrestapiv2
outlookrestapiv1
An accident anatomy can be in either argument or HTML. Currently, the GET operation allotment accident bodies in alone HTML format.
outlookrestapiv1
Get a agenda appearance | Get alternation adept and distinct contest | Get accident instances | Get an event
Minimum adapted scope: one of the following:
Get the occurrences, exceptions, and distinct instances of contest in a agenda appearance authentic by a time range, from the user's primary agenda (../me/calendarview) or from a altered calendar.
outlookrestapibeta
Use the Prefer: outlook.timezone attack to specify the time area to use for the accident alpha and end times in the response. If the accident was created in a altered time zone, the alpha and end times will be adapted to the authentic time zone. See this annual for the accurate time area names. If the Prefer: outlook.timezone attack is not specified, the alpha and end times are alternate in UTC.
Note By default, anniversary accident in the acknowledgment includes all its properties. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. See OData concern ambit for filtering, sorting, and paging parameters.
For example, get the agenda appearance for the ages of October, abiding alone the Accountable acreage for anniversary event. Assuming that the Prefer: outlook.timezone attack is not included in the request, the time area will be UTC.
Response type
The broadcast contest aural the authentic time range.
outlookrestapibeta
outlookrestapiv2
Use the Prefer: outlook.timezone attack to specify the time area to use for the accident alpha and end times in the response. If the accident was created in a altered time zone, the alpha and end times will be adapted to the authentic time zone. See this annual for the accurate time area names. If the Prefer: outlook.timezone attack is not specified, the alpha and end times are alternate in UTC.
Note By default, anniversary accident in the acknowledgment includes all its properties. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. See OData concern ambit for filtering, sorting, and paging parameters.
For example, get the agenda appearance for the ages of October, abiding alone the Accountable acreage for anniversary event. Assuming that the Prefer: outlook.timezone attack is not included in the request, the time area will be UTC.
Response type
The broadcast contest aural the authentic time range.
outlookrestapiv2
outlookrestapiv1
Note By default, anniversary accident in the acknowledgment includes all its properties. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. See OData concern ambit for filtering, sorting, and paging parameters.
For example, get the agenda appearance for the ages of October, abiding alone the Accountable acreage for anniversary event:
Response type
The broadcast contest aural the authentic time range.
outlookrestapiv1
Minimum adapted scope: one of the following:
Get a accumulating of alternation adept and distinct instance contest from the user's primary agenda (../me/events) or from a altered calendar. To get broadcast accident instances, you can get the agenda appearance or get the instances of an event.
outlookrestapibeta
Use the Prefer: outlook.timezone attack to specify the time area to use for the accident alpha and end times in the response. If the accident was created in a altered time zone, the alpha and end times will be adapted to the authentic time zone. See this annual for the accurate time area names. If the Prefer: outlook.timezone attack is not specified, alpha and end times are alternate in UTC.
Note Anniversary accident in the acknowledgment includes all its properties. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. See the abutting example. See OData concern ambit for filtering, sorting, and paging parameters.
The afterward archetype shows how to use $select to specify abiding alone the Subject, Organizer, Alpha and End backdrop of anniversary accident in the response. Refer to the aboriginal sample acknowledgment in Get an accident for a abounding annual of backdrop that would be alternate for an accident if you don't use $select.
Sample request
Sample response
Status code: 200
outlookrestapibeta
outlookrestapiv2
Use the Prefer: outlook.timezone attack to specify the time area to use for the accident alpha and end times in the response. If the accident was created in a altered time zone, the alpha and end times will be adapted to the authentic time zone. See this annual for the accurate time area names. If the Prefer: outlook.timezone attack is not specified, the alpha and end times are alternate in UTC.
Note Anniversary accident in the acknowledgment includes all its properties. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. See the abutting example. See OData concern ambit for filtering, sorting, and paging parameters.
The afterward archetype shows how to use $select to specify abiding alone the Subject, Organizer, Alpha and End backdrop of anniversary accident in the response. Refer to the aboriginal sample acknowledgment in Get an accident for a abounding annual of backdrop that would be alternate for an accident if you don't use $select.
Sample request
Sample response
outlookrestapiv2
outlookrestapiv1
Note Anniversary accident in the acknowledgment includes all its properties. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. See the abutting example. See OData concern ambit for filtering, sorting, and paging parameters.
The afterward archetype shows how to use $select to specify abiding alone the Subject, Organizer, Alpha and End backdrop of anniversary accident in the response. Refer to the aboriginal sample acknowledgment in Get an accident for a abounding annual of backdrop that would be alternate for an accident if you don't use $select.
Sample request
Sample response
Status code: 200
outlookrestapiv1
Minimum adapted scope: one of the following:
You can get the instances (occurrences) of an accident for a authentic time range. If the accident is a SeriesMaster type, this allotment the occurrences and exceptions of the accident in the authentic time range.
outlookrestapibeta
Use the Prefer: outlook.timezone attack to specify the time area to use for the accident alpha and end times in the response. If the accident was created in a altered time zone, the alpha and end times will be adapted to the authentic time zone. See this annual for the accurate time area names. If the Prefer: outlook.timezone attack is not specified, the alpha and end times are alternate in UTC.
Response type
The requested accident collection.
Note By default, anniversary accident in the acknowledgment includes all its properties. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned.See OData concern ambit for filtering, sorting, and paging parameters.
For example, get the instances of a accurate accident for the ages of October, accommodate alone the Subject, Alpha and End backdrop of anniversary instance:
outlookrestapibeta
outlookrestapiv2
Use the Prefer: outlook.timezone attack to specify the time area to use for the accident alpha and end times in the response. If the accident was created in a altered time zone, the alpha and end times will be adapted to the authentic time zone. See this annual for the accurate time area names. If the Prefer: outlook.timezone attack is not specified, the alpha and end times are alternate in UTC.
Response type
The requested accident collection.
Note By default, anniversary accident in the acknowledgment includes all its properties. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned.See OData concern ambit for filtering, sorting, and paging parameters.
For example, get the instances of a accurate accident for the ages of October, accommodate alone the Subject, Alpha and End backdrop of anniversary instance:
outlookrestapiv2
outlookrestapiv1
Response type
The requested accident collection.
Note By default, anniversary accident in the acknowledgment includes all its properties. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned.See OData concern ambit for filtering, sorting, and paging parameters.
For example, get the instances of a accurate accident for the ages of October, accommodate alone the Subject, Alpha and End backdrop of anniversary instance:
outlookrestapiv1
Minimum adapted scope: one of the following:
Get an accident by ID.
outlookrestapibeta
Use the Prefer: outlook.timezone attack to specify the time area to use for the accident alpha and end times in the response. If the accident was created in a altered time zone, the alpha and end times will be adapted to the authentic time zone. See this annual for the accurate time area names.If the Prefer: outlook.timezone attack is not specified, the alpha and end times are alternate in UTC.
Sample request
Sample response
Response type
The requested event.
Note By default, the acknowledgment includes all the backdrop of the event. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. See OData concern ambit for filtering, sorting, and paging parameters.
The afterward archetype shows how to use $select to specify abiding alone the Subject, Organizer, Alpha and End backdrop of the event.
Sample request
Sample response
outlookrestapibeta
outlookrestapiv2
Use the Prefer: outlook.timezone attack to specify the time area to use for the accident alpha and end times in the response. If the accident was created in a altered time zone, the alpha and end times will be adapted to the authentic time zone. See this annual for the accurate time area names. If the Prefer: outlook.timezone attack is not specified, the alpha and end times are alternate in UTC.
Sample request
Sample response
Response type
The requested event.
Note By default, the acknowledgment includes all the backdrop of the event. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. See OData concern ambit for filtering, sorting, and paging parameters.
The afterward archetype shows how to use $select to specify abiding alone the Subject, Organizer, Alpha and End backdrop of the event.
Sample request
Sample response
outlookrestapiv2
outlookrestapiv1
Sample request
Sample response
Status code: 200
Response type
The requested event.
Note By default, the acknowledgment includes all the backdrop of the event. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. See OData concern ambit for filtering, sorting, and paging parameters.
The afterward archetype shows how to use $select to specify abiding alone the Subject, Organizer, Alpha and End backdrop of the event.
Sample request
Sample response
outlookrestapiv1
outlookrestapibeta
outlookrestapibeta
outlookrestapiv2
outlookrestapiv2
outlookrestapiv1
outlookrestapiv1
Minimum adapted scope: one of the following:
Synchronize and get new, updated, or deleted contest in a authentic time ambit from the user's primary agenda (../me/calendarview) or from a altered calendar. Such a set of contest in a time ambit is additionally accepted as a agenda view. The alternate contest may accommodate occurrences and exceptions of a alternating series, and distinct instances.
Synchronizing a agenda appearance about requires a annular of two or added accompany requests, anniversary of which is a GET call. To accord a agenda view, use the GET adjustment abundant like the way you get a agenda view, except that you accommodate assertive appeal headers, and deltaToken or a skipToken back appropriate.
Request headers
Here's a archetypal annular of synchronizing contest in a agenda view:
Make the antecedent GET appeal with the binding Prefer: odata.track-changes header. The antecedent acknowledgment to a accompany appeal consistently allotment a deltaToken. (The added and consecutive GET requests adapt from the aboriginal GET appeal by including either a deltaToken or a skipToken accustomed in a antecedent response.)
If the aboriginal acknowledgment allotment the Preference-Applied: odata.track-changes header, you can advance with synchronizing.
Make a added GET request. Specify the Prefer: odata.track-changes attack and the deltaToken alternate from the aboriginal GET to actuate if there are any added events. The added appeal will acknowledgment added events, and either a skipToken if there are added contest available, or a deltaToken if the aftermost accident has been synchronized, in which case you can stop.
Continue synchronizing by sending a GET alarm and including a skipToken that's alternate from the antecedent call. Stop back you get a final acknowledgment that contains an _@odata.deltaLink_ attack with a deltaToken again, which indicates the accompany is complete.
Take a accessory at the syntax for the antecedent and consecutive calls in a annular of sync.
outlookrestapibeta
To accompany in the absence calendar
Initial request:
Second request, or aboriginal appeal of a consecutive round:
Third or consecutive appeal in the aforementioned round
To accompany in a specific calendar
Initial request:
Second request, or aboriginal appeal of a consecutive round:
Third or consecutive appeal in the aforementioned round:
Parameters
Use the Prefer: outlook.timezone attack to specify the time area to use for the accident alpha and end times in the response. If the accident was created in a altered time zone, the alpha and end times will be adapted to the authentic time zone. See this annual for the accurate time area names.If the Prefer: outlook.timezone attack is not specified, the alpha and end times are alternate in UTC.
Note
Response type
The broadcast contest and abbreviated contest aural the authentic time range.
Example
The afterward archetype shows the antecedent and added accompany requests to accord the absence agenda for the user. Anniversary appeal specifies to acknowledgment alone one abounding accident at a time:
To complete the sync, use the skipToken alternate from the antecedent accompany appeal until the accompany acknowledgment allotment a deltaLink and deltaToken, in which case this annular of accompany is complete. Save the deltaToken for the abutting annular of sync.
For added information, see Accord contest in an Angle agenda view.
Sample antecedent request
Sample antecedent acknowledgment data
Sample added request
Sample added acknowledgment data
outlookrestapibeta
outlookrestapiv2
To accompany in the absence calendar
Initial request:
Second request, or aboriginal appeal of a consecutive round:
Third or consecutive appeal in the aforementioned round
To accompany in a specific calendar
Initial request:
Second request, or aboriginal appeal of a consecutive round:
Third or consecutive appeal in the aforementioned round:
Parameters
Note
Response type
The broadcast contest and abbreviated contest aural the authentic time range.
Example
["1107.74"]
Configuring delegate access in Outlook Web App - Office Blogs | outlook office com owaThe afterward archetype shows the antecedent and added accompany requests to accord the absence agenda for the user. Anniversary appeal specifies to acknowledgment alone one abounding accident at a time:
To complete the sync, use the skipToken alternate from the antecedent accompany appeal until the accompany acknowledgment allotment a deltaLink and deltaToken, in which case this annular of accompany is complete. Save the deltaToken for the abutting annular of sync.
For added information, see Accord contest in an Angle agenda view.
Sample antecedent request
Sample antecedent acknowledgment data
Sample added request
Sample added acknowledgment data
outlookrestapiv2
outlookrestapiv1
To accompany in the absence calendar
Initial request:
Second request, or aboriginal appeal of a consecutive round:
Third or consecutive appeal in the aforementioned round
To accompany in a specific calendar
Initial request:
Second request, or aboriginal appeal of a consecutive round:
Third or consecutive appeal in the aforementioned round:
Parameters
Note
Response type
The broadcast contest and abbreviated contest aural the authentic time range.
Example
The afterward archetype shows the antecedent and added accompany requests to accord the absence agenda for the user. Anniversary appeal specifies to acknowledgment alone one abounding accident at a time:
To complete the sync, use the skipToken alternate from the antecedent accompany appeal until the accompany acknowledgment allotment a deltaLink and deltaToken, in which case this annular of accompany is complete. Save the deltaToken for the abutting annular of sync.
For added information, see Accord contest in an Angle agenda view.
Sample antecedent request
Sample antecedent acknowledgment data
Sample added request
Sample added acknowledgment data
outlookrestapiv1
outlookrestapibeta
Minimum adapted scope: one of the following:
Find affair time suggestions based on organizer and attendee availability, and time or area constraints authentic as parameters.
This operation applies to alone Appointment 365 mailboxes (on Azure AD) and not to Microsoft accounts.
All the accurate ambit are listed below. Depending on your scenario, specify the all-important ambit in the appeal anatomy of the FindMeetingTimes action.
FindMeetingTimes checks the free/busy cachet in the primary calendars of the organizer and attendees. Based on the authentic parameters, the activity suggests the best attainable affair times. The afterward table describes the restrictions you can specify in the TimeConstraint parameter.
Response type
A MeetingTimeSuggestionsResult which includes a accumulating of affair suggestions, anniversary of blazon MeetingTimeSuggestion, and an EmptySuggestionsReason property.
Each advancement is authentic as a MeetingTimeSuggestion, with attendees accepting by absence a aplomb akin of 50% to attend, or a specific % that you acquire authentic in the MinimumAttendeePercentage parameter.
By default, anniversary affair time advancement is alternate in UTC. Apply the Prefer: outlook.timezone appeal attack to acquire affair time suggestions retuned in a altered time zone, for example:
If FindMeetingTimes cannot acknowledgment any affair suggestions, the acknowledgment would announce a acumen in the EmptySuggestionsReason property. Based on this value, you can bigger acclimatize the ambit and alarm FindMeetingTimes again.
Note
Currently, FindMeetingTimes assumes that any Attendee who is a being (as against to a resource) is a adapted attendee. So, specify Adapted for a being and Ability for a ability in the agnate Blazon property, as allotment of the Attendees accumulating parameter.
Each archetype beneath calls FindMeetingTimes, and varies by attendee availability, time and area constraints as declared below:
Find times and locations to accommodated by allegorical the afterward ambit in the appeal body:
Sample request
The afterward archetype suggests affair times and locations demography into application the organizer's and attendee's availability during assignment hours of the requested affair time range, and the requested breadth of time.
Sample response
Status code: 200
Find time to accommodated at a pre-determined location, and appeal a acumen for anniversary suggestion, by allegorical the afterward ambit in the appeal body:
By ambience the ReturnSuggestionReasons parameter, you additionally get an annual for anniversary advancement in the SuggestionReason property, if FindMeetingTimes allotment any suggestion.
Sample request
Sample response
Status code: 200
Find time to accommodated at a pre-determined location, by allegorical the afterward ambit in the appeal body:
In this example, based on authentic ambit and attendee availability, FindMeetingTimes cannot acknowledgment any suggestions, and instead allotment a acumen AttendeesUnavailable in the EmptySuggestionsReason property.
See added attainable affidavit for not abiding any affair suggestions.
Sample request
Sample response
Status code: 200
Find time to accommodated at a pre-determined location, by allegorical the afterward ambit in the appeal body:
In this example, alone one of the 2 attendees is available. Anniversary affair advancement that FindMeetingTimes allotment includes:
Find added advice about the aplomb of a meeting.
Sample request
Sample response
Status code: 200
Find chargeless time slots in the signed-in user's primary agenda any time of the anniversary aural a date range, by allegorical the afterward ambit in the appeal body:
Sample request
This archetype looks for 1-hour chargeless time slots, as authentic by MeetingDuration, in the signed-in user's primary agenda any time of the anniversary aural a date ambit authentic by TimeConstraint.
Sample response
Status code: 200
outlookrestapibeta
outlookrestapiv2
Minimum adapted scope: one of the following:
Find affair time suggestions based on organizer and attendee availability, and time or area constraints authentic as parameters.
This operation applies to alone Appointment 365 mailboxes (on Azure AD) and not to Microsoft accounts.
All the accurate ambit are listed below. Depending on your scenario, specify the all-important ambit in the appeal anatomy of the FindMeetingTimes action.
FindMeetingTimes checks the free/busy cachet in the primary calendars of the organizer and attendees. Based on the authentic parameters, the activity suggests the best attainable affair times. The afterward table describes the restrictions you can specify in the TimeConstraint parameter.
Response type
A MeetingTimeSuggestionsResult which includes a accumulating of affair suggestions, anniversary of blazon MeetingTimeSuggestion, and an EmptySuggestionsReason property.
Each advancement is authentic as a MeetingTimeSuggestion, with attendees accepting by absence a aplomb akin of 50% to attend, or a specific % that you acquire authentic in the MinimumAttendeePercentage parameter.
By default, anniversary affair time advancement is alternate in UTC. Apply the Prefer: outlook.timezone appeal attack to acquire affair time suggestions retuned in a altered time zone, for example:
If FindMeetingTimes cannot acknowledgment any affair suggestions, the acknowledgment would announce a acumen in the EmptySuggestionsReason property. Based on this value, you can bigger acclimatize the ambit and alarm FindMeetingTimes again.
Note
Currently, FindMeetingTimes assumes that any Attendee who is a being (as against to a resource) is a adapted attendee. So, specify Adapted for a being and Ability for a ability in the agnate Blazon property, as allotment of the Attendees accumulating parameter.
Each archetype beneath calls FindMeetingTimes, and varies by attendee availability, time and area constraints as declared below:
Find times and locations to accommodated by allegorical the afterward ambit in the appeal body:
Sample request
The afterward archetype suggests affair times and locations demography into application the organizer's and attendee's availability during assignment hours in the requested affair time range, and the requested breadth of time.
Sample response
Status code: 200
Find time to accommodated at a pre-determined location, and appeal a acumen for anniversary suggestion, by allegorical the afterward ambit in the appeal body:
By ambience the ReturnSuggestionReasons parameter, you additionally get an annual for anniversary advancement in the SuggestionReason property, if FindMeetingTimes allotment any suggestion.
Sample request
Sample response
Status code: 200
Find time to accommodated at a pre-determined location, by allegorical the afterward ambit in the appeal body:
In this example, based on authentic ambit and attendee availability, FindMeetingTimes cannot acknowledgment any suggestions, and instead allotment a acumen AttendeesUnavailable in the EmptySuggestionsReason property.
See added attainable affidavit for not abiding any affair suggestions.
Sample request
Sample response
Status code: 200
Find time to accommodated at a pre-determined location, by allegorical the afterward ambit in the appeal body:
In this example, alone one of the 2 attendees is available. Anniversary affair advancement that FindMeetingTimes allotment includes:
Find added advice about the aplomb of a meeting.
Sample request
Sample response
Status code: 200
Find chargeless time slots in the signed-in user's primary agenda any time of the anniversary aural a date range, by allegorical the afterward ambit in the appeal body:
Sample request
This archetype looks for 1-hour chargeless time slots, as authentic by MeetingDuration, in the signed-in user's primary agenda any time of the anniversary aural a date ambit authentic by TimeConstraint.
Sample response
Status code: 200
outlookrestapiv2
outlookrestapiv1
This affection is currently attainable in v2.0 and beta. To acquisition out more, use the ascendancy in the top adapted bend of the commodity and baddest one of these versions.
outlookrestapiv1
outlookrestapibeta
In Outlook, a addressee can adapt affair apartment into allowance lists. Anniversary affair allowance and allowance annual is represented by an EmailAddress instance.
Get allowance lists (preview) | Get apartment (preview)
Minimum adapted scope: one of the following:
Get the allowance lists authentic in a tenant.
Response type
Collection of EmailAddress instances. If no lists are authentic in the tenant, again an abandoned arrangement is returned.
Sample request
Sample response
Minimum adapted scope: one of the following:
You can get all the affair apartment authentic in the user's tenant, or get the affair apartment in a specific allowance list.
Note These operations acknowledgment up to the aboriginal 100 apartment in a tenant.
To get all the apartment in the user's tenant:
To get the apartment in a authentic allowance list:
Response type
Collection of EmailAddress instances.
Sample request
The afterward archetype gets the apartment authentic in the signed-in user's tenant.
Sample response
Sample request
The afterward archetype gets the apartment in the authentic allowance annual articular by the email abode Building2Rooms@contoso.onmicrosoft.com.
Sample response
outlookrestapibeta
outlookrestapiv2
This affection is currently attainable in beta. To acquisition out more, use the ascendancy in the top adapted bend of the commodity and baddest beta.
outlookrestapiv2
outlookrestapiv1
This affection is currently attainable in beta. To acquisition out more, use the ascendancy in the top adapted bend of the commodity and baddest beta.
outlookrestapiv1
Create a agenda event
Minimum adapted scope: one of the following:
Create an accident in the user's primary agenda or a specific agenda by announcement to the calendar's contest endpoint. Back the accident is created, the server accelerate invitations to all attendees.
outlookrestapibeta
Sample request
The afterward archetype creates an accident for the organizer and attendees to participate from 3 altered locations.
Sample response
Status code: 201
Response type
The new event.
By default, the acknowledgment includes all the backdrop of the new event. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. The afterward is an archetype to accommodate alone the Alpha and End backdrop of the new accident in the response.
outlookrestapibeta
outlookrestapiv2
Sample request
Sample response
Status code: 201
Response type
The new event.
By default, the acknowledgment includes all the backdrop of the new event. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. The afterward is an archetype to accommodate alone the Alpha and End backdrop of the new accident in the response.
outlookrestapiv2
outlookrestapiv1
By default, the Alpha and End time ethics are in UTC. You can specify time zones for Alpha and End, accurate the time in the agnate time zone, and accommodate a time annual from UTC. The archetype beneath shows how to accredit time ethics in Pacific Standard Time. Note that if you specify one time zone, you charge specify a amount for the added one as well.
Sample request
Sample response
Status code: 201
Response type
The new event.
By default, the acknowledgment includes all the backdrop of the new event. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned. The afterward is an archetype to accommodate alone the Alpha and End backdrop of the new accident in the response.
outlookrestapiv1
Update a agenda event
Minimum adapted scope: one of the following:
Change an event. Alone the backdrop that you specify are changed. If the user is the organizer, the server sends affair updates to all attendees.
outlookrestapibeta
Specify any writable accident backdrop in the appeal body.
Sample request
Sample response
Status code: 200
Response type
The adapted event. If the user is the organizer, the server sends affair updates to all attendees.
By default, the acknowledgment includes all the backdrop of the adapted event. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned.
outlookrestapibeta
outlookrestapiv2
Specify any writable accident backdrop in the appeal body.
Sample request
Sample response
Status code: 200
Response type
The adapted event. If the user is the organizer, the server sends affair updates to all attendees.
By default, the acknowledgment includes all the backdrop of the adapted event. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned.
outlookrestapiv2
outlookrestapiv1
Specify any writable accident backdrop in the appeal body.
Sample request
Sample response
Status code: 200
Response type
The adapted event. If the user is the organizer, the server sends affair updates to all attendees.
By default, the acknowledgment includes all the backdrop of the adapted event. Use $select to specify alone those backdrop you charge for best performance. The Id acreage is consistently returned.
outlookrestapiv1
Accept accident | Tentatively acquire accident | Decline event
Minimum adapted scope: one of the following:
Accept the authentic event.
outlookrestapibeta
Sample request
Response
A acknowledged acknowledgment is adumbrated by an HTTP 202 Accepted acknowledgment code.
outlookrestapibeta
outlookrestapiv2
Sample request
Response
A acknowledged acknowledgment is adumbrated by an HTTP 202 Accepted acknowledgment code.
outlookrestapiv2
outlookrestapiv1
["651.84"]
Outlook Web Access (OWA) - Set Out of Office - Massey University | outlook office com owaSample request
Response
A acknowledged acknowledgment is adumbrated by an HTTP 202 Accepted acknowledgment code.
outlookrestapiv1
Minimum adapted scope: one of the following:
Tentatively acquire the authentic event.
outlookrestapibeta
Sample request
Response
A acknowledged acknowledgment is adumbrated by an HTTP 202 Accepted acknowledgment code.
outlookrestapibeta
outlookrestapiv2
Sample request
Response
A acknowledged acknowledgment is adumbrated by an HTTP 202 Accepted acknowledgment code.
outlookrestapiv2
outlookrestapiv1
Sample request
Response
A acknowledged acknowledgment is adumbrated by an HTTP 202 Accepted acknowledgment code.
outlookrestapiv1
Minimum adapted scope: one of the following:
Decline allurement to the authentic event.
outlookrestapibeta
Sample request
Response
A acknowledged acknowledgment is adumbrated by an HTTP 202 Accepted acknowledgment code.
outlookrestapibeta
outlookrestapiv2
Sample request
Response
A acknowledged acknowledgment is adumbrated by an HTTP 202 Accepted acknowledgment code.
outlookrestapiv2
outlookrestapiv1
Sample request
Response
A acknowledged acknowledgment is adumbrated by an HTTP 202 Accepted acknowledgment code.
outlookrestapiv1
outlookrestapibeta
Minimum adapted scope: one of the following:
This activity allows the organizer or attendee of a affair accident to advanced the affair appeal to a new recipient.
If the affair accident is forwarded from an Appointment 365 mailbox to addition recipient, this activity additionally sends a bulletin to acquaint the organizer of the forwarding, and adds the almsman to the organizer's archetype of the affair event. This accessibility is not attainable back forwarding from an Outlook.com account.
Sample request
Sample response
outlookrestapibeta
outlookrestapiv2
This affection is currently attainable in alone the beta version. To acquisition out more, use the ascendancy in the top adapted bend of the commodity and baddest beta.
outlookrestapiv2
outlookrestapiv1
This affection is currently attainable in alone the beta version. To acquisition out more, use the ascendancy in the top adapted bend of the commodity and baddest beta.
outlookrestapiv1
Delete a agenda event
Minimum adapted scope: one of the following:
Move an accident to the Deleted Items binder of the signed-in user. If the accident is a affair and the signed-in user is the organizer, the server sends cancellations to all attendees.
outlookrestapibeta
This activity differs from Abolish in that Annul is attainable to the organizer and attendees of the meeting. If the signed-user is the affair organizer, the user artlessly cancels the affair after accouterment a custom abandoning bulletin to the attendees.
Sample request
Sample response
outlookrestapibeta
outlookrestapiv2
Sample request
Sample response
outlookrestapiv2
outlookrestapiv1
Sample request
Sample response
outlookrestapiv1
outlookrestapibeta
Minimum adapted scope: one of the following:
This activity allows the organizer of a affair to accelerate a abandoning bulletin and abolish the event.
The activity moves the accident to the Deleted Items folder. The organizer can additionally abolish an accident of a alternating affair by accouterment the accident accident ID. An attendee calling this activity gets an absurdity (HTTP 400 Bad Request), with the afterward absurdity message:
"Your appeal can't be completed. You charge to be an organizer to abolish a meeting."
This activity differs from Annul in that Abolish is attainable to alone the organizer, and lets the organizer accelerate a custom bulletin to the attendees about the cancellation.
Sample request
Sample response
outlookrestapibeta
outlookrestapiv2
This affection is currently attainable in alone the beta version. To acquisition out more, use the ascendancy in the top adapted bend of the commodity and baddest beta.
outlookrestapiv2
outlookrestapiv1
This affection is currently attainable in alone the beta version. To acquisition out more, use the ascendancy in the top adapted bend of the commodity and baddest beta.
outlookrestapiv1
You can get an attachement accumulating or get an attachment.
Get an adapter accumulating | Get an attachment
Minimum adapted scope: one of the following:
Get the accessories from a accurate event.
Note See OData concern ambit for filtering, sorting, and paging parameters.
outlookrestapibeta
Response type
An adapter accumulating which can be of the blazon FileAttachment, ItemAttachment, or ReferenceAttachment.
Sample request
Sample response
Status code: 200
outlookrestapibeta
outlookrestapiv2
Response type
An adapter accumulating which can be of the blazon FileAttachment or ItemAttachment.
Sample request
Sample response
Status code: 200
outlookrestapiv2
outlookrestapiv1
Response type
An adapter accumulating which can be of the blazon FileAttachment or ItemAttachment.
Sample request
Sample response
Status code: 200
outlookrestapiv1
Minimum adapted scope: one of the following:
Get an adapter from a accurate event.
outlookrestapibeta
Note See OData concern ambit for filtering, sorting, and paging parameters.
Response type
The requested book attachment, account attachment, or advertence attachment.
Sample request
The afterward archetype gets the book absorbed to a specific event.
Sample response
Status code: 200
Sample appeal (reference attachment)
The afterward archetype gets the advertence adapter of an event.
Sample response
Status code: 200
Sample appeal ($expand on attachments)
The afterward archetype gets and expands the 2 advertence accessories inline with the accident properties.
Sample response
Status code: 200
outlookrestapibeta
outlookrestapiv2
Note See OData concern ambit for filtering, sorting, and paging parameters.
Response type
The requested book adapter or account attachment.
Sample request
Sample response
Status code: 200
outlookrestapiv2
outlookrestapiv1
Note See OData concern ambit for filtering, sorting, and paging parameters.
Response type
The requested book adapter or account attachment.
Sample request
Sample response
Status code: 200
outlookrestapiv1
You can actualize a book adapter or actualize an account adapter for an event.
Create a book adapter | Actualize an account adapter | Actualize a advertence attachment
Minimum adapted scope: one of the following:
Add a book adapter to an event.
outlookrestapibeta
outlookrestapibeta
outlookrestapiv2
outlookrestapiv2
outlookrestapiv1
outlookrestapiv1
Response type
The new book attachment.
Minimum adapted scope: one of the following:
Add an account adapter to an event.
outlookrestapibeta
outlookrestapibeta
outlookrestapiv2
outlookrestapiv2
outlookrestapiv1
outlookrestapiv1
Response type
The new account attachment.
Minimum adapted scope: https://outlook.office.com/calendars.readwrite
Add a advertence adapter to an event.
outlookrestapibeta
Specify the Name and SourceUrl ambit and any writable advertence adapter backdrop in the appeal body.
Response type
The advertence attachment.
Sample request
The afterward archetype adds a advertence adapter to an absolute event. The adapter is a articulation to a book on OneDrive for Business.
Sample response
Status code: 201 Created
outlookrestapibeta
outlookrestapiv2
Specify the Name and SourceUrl ambit and any writable advertence adapter backdrop in the appeal body.
Response type
The advertence attachment.
Sample request
The afterward archetype adds a advertence adapter to an absolute event. The adapter is a articulation to a book on OneDrive for Business.
Sample response
Status code: 201 Created
outlookrestapiv2
outlookrestapiv1
This affection is currently attainable in alone the beta version. To acquisition out more, use the ascendancy in the top adapted bend of the commodity and baddest beta.
outlookrestapiv1
Delete accessories of an event.
Delete an accident attachment
Minimum adapted scope: one of the following:
outlookrestapibeta
Delete the authentic adapter of an event. The adapter can be a book attachment, account attachment, or advertence attachment.
Sample request
Sample response
outlookrestapibeta
outlookrestapiv2
Delete the authentic adapter of an event. The adapter can be a book adapter or account attachment.
Sample request
Sample response
outlookrestapiv2
outlookrestapiv1
Delete the authentic adapter of an event. The adapter can be a book adapter or account attachment.
Sample request
Sample response
outlookrestapiv1
Get a annual of accident reminders amid two dates and times from a calendar.
Minimum adapted scope: one of the following:
outlookrestapibeta
Use the Prefer: outlook.timezone attack to specify the time area to use for the accident alpha and end times in the response. If the accident was created in a altered time zone, the alpha and end times will be adapted to the authentic time zone. See this annual for the accurate time area names. If the Prefer: outlook.timezone attack is not specified, the time area is set to UTC.
outlookrestapibeta
outlookrestapiv2
Use the Prefer: outlook.timezone attack to specify the time area to use for the accident alpha and end times in the response. If the accident was created in a altered time zone, the alpha and end times will be adapted to the authentic time zone. See this annual for the accurate time area names. If the Prefer: outlook.timezone attack is not specified, the time area is set to UTC.
outlookrestapiv2
outlookrestapiv1
This affection is attainable in alone the beta and v2.0 versions. To acquisition out more, use the ascendancy in the top adapted bend of the commodity and baddest v2.0 or beta.
outlookrestapiv1
Snooze a admonition to adjourn the admonition until a new time.
Minimum adapted scope: one of the following:
["1120.35"]
Office of Information Technology | Office 365 – Getting Started | outlook office com owaoutlookrestapibeta
outlookrestapibeta
outlookrestapiv2
outlookrestapiv2
outlookrestapiv1
This affection is attainable in alone the beta and v2.0 versions. To acquisition out more, use the ascendancy in the top adapted bend of the commodity and baddest v2.0 or beta.
outlookrestapiv1
Dissmiss a admonition that has been triggered.
Minimum adapted scope: one of the following:
outlookrestapibeta
outlookrestapibeta
outlookrestapiv2
outlookrestapiv2
outlookrestapiv1
This affection is attainable in alone the beta and v2.0 versions. To acquisition out more, use the ascendancy in the top adapted bend of the commodity and baddest v2.0 or beta.
outlookrestapiv1
You can get a agenda accumulating or get a calendar.
Get a agenda accumulating | Get a calendar
Minimum adapted scope: one of the following:
Get all the user's calendars (calendars) or get the calendars from a specific agenda group.
outlookrestapibeta
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
Status code: 200
outlookrestapibeta
outlookrestapiv2
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
Status code: 200
outlookrestapiv2
outlookrestapiv1
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
Status code: 200
Response type
The requested agenda collection.
outlookrestapiv1
Minimum adapted scope: one of the following:
Get a agenda by ID. You can get the user's primary agenda by application the ../me/calendar endpoint.
outlookrestapibeta
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
Status code: 200
outlookrestapibeta
outlookrestapiv2
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
Status code: 200
outlookrestapiv2
outlookrestapiv1
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
Status code: 200
outlookrestapiv1
Response type
The requested calendar.
Create a calendar
Minimum adapted scope: one of the following:
Create a agenda in the absence agenda accumulation by application the ../me/calendars shortcut, or in a accurate agenda accumulation by announcement to the group's calendars endpoint.
outlookrestapibeta
Sample request
Sample response
Status code: 201
outlookrestapibeta
outlookrestapiv2
Sample request
Sample response
Status code: 201
outlookrestapiv2
outlookrestapiv1
Sample request
Sample response
Status code: 201
outlookrestapiv1
Response type
The new calendar.
Update a calendar
Minimum adapted scope: one of the following:
Change writable backdrop of a calendar.
outlookrestapibeta
Sample request
Sample response
Status code: 200
outlookrestapibeta
outlookrestapiv2
Sample request
Sample response
Status code: 200
outlookrestapiv2
outlookrestapiv1
Sample request
Sample response
Status code: 200
outlookrestapiv1
Response type
The adapted calendar.
Delete a calendar.
Delete a calendar
Minimum adapted scope: one of the following:
outlookrestapibeta
Sample request
Sample response
outlookrestapibeta
outlookrestapiv2
Sample request
Sample response
outlookrestapiv2
outlookrestapiv1
Sample request
Sample response
outlookrestapiv1
You can get a agenda accumulation accumulating or get a agenda group.
Note Outlook.com supports alone the absence agenda accumulation which is attainable by the ../me/calendars shortcut.
Get a agenda accumulation accumulating | Get a agenda group
Minimum adapted scope: one of the following:
Get the agenda groups in a mailbox.
outlookrestapibeta
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
Status code: 200
outlookrestapibeta
outlookrestapiv2
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
Status code: 200
outlookrestapiv2
outlookrestapiv1
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
Status code: 200
outlookrestapiv1
Response type
The requested agenda accumulation collection.
Minimum adapted scope: one of the following:
Get a agenda accumulation by ID.
outlookrestapibeta
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
Status code: 200
outlookrestapibeta
outlookrestapiv2
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
Status code: 200
outlookrestapiv2
outlookrestapiv1
Note See OData concern ambit for filtering, sorting, and paging parameters.
Sample request
Sample response
outlookrestapiv1
Response type
The requested agenda group.
Create a agenda group. Name is the alone writable acreage for a agenda group.
Note Outlook.com supports alone the absence agenda accumulation which is attainable by the ../me/calendars shortcut. You cannot actualize addition agenda accumulation in Outlook.com.
Create a agenda group
Minimum adapted scope: one of the following:
outlookrestapibeta
Sample request
Sample response
Status code: 201
outlookrestapibeta
outlookrestapiv2
Sample request
Sample response
Status code: 201
outlookrestapiv2
outlookrestapiv1
Sample response
Status code: 201
outlookrestapiv1
Response type
The new agenda group.
Update a agenda group
Minimum adapted scope: one of the following:
Change the name of a agenda group. Name is the alone writable agenda accumulation property.
outlookrestapibeta
Sample request
Sample response
outlookrestapibeta
outlookrestapiv2
Sample request
Sample response
outlookrestapiv2
outlookrestapiv1
Sample response
Status code: 200
outlookrestapiv1
Response type
The adapted agenda group.
Delete a agenda group.
Note Outlook.com supports alone the absence agenda accumulation which is attainable by the ../me/calendars shortcut. Do not annul this agenda group.
Delete a agenda group
Minimum adapted scope: one of the following:
outlookrestapibeta
Sample request
Sample response
outlookrestapibeta
outlookrestapiv2
Sample request
Sample response
outlookrestapiv2
outlookrestapiv1
Sample request
Sample response
outlookrestapiv1
Whether you're accessible to alpha architecture an app or aloof appetite to apprentice more, we've got you covered.
Or, apprentice added about application the Appointment 365 platform:
["543.2"]
The Office 365 Upgrade: New Outlook Web App | Paul Thurrott ... | outlook office com owa["645.05"]
Customizing the Look of Outlook Web Access | outlook office com owa["1231.9"]
Outlook Web App | Techtonic Guides | outlook office com owa["970.97"]
Outlook.com versus Outlook Web App in Office 365 – Tom Resing's ... | outlook office com owa["750.78"]
EC :: Outlook Web Access :: Education Commons at OISE | outlook office com owa["772.12"]
The unhappy mixture of Office 365, Outlook Web App, and Windows XP ... | outlook office com owa["358.9"]
IM in Outlook Web App - Outlook | outlook office com owa["606.25"]
People View in Outlook Web App - Office Blogs | outlook office com owa