outlookCategory resource type
Represents a category by which a user can group Outlook items such as messages and events. The user defines categories in a master list, and can apply one or more of these user-defined categories to an item.
Using the REST API, you can create and define categories in the master list of categories for a user. You can also get this master list of categories, get a specific category, update the color associated with a category, or delete a category. You can apply a category to an item by assigning the displayName property of the category to the categories collection of the item. Resources that can be assigned categories include contact, event, message, post, and todoTask.
Each category is attributed by 2 properties: displayName and color. The displayName value must be unique in a user's master list. The color however does not have to be unique; multiple categories in the master list can be mapped to the same color. You can map up to 25 different colors to categories in a user's master list.
|Get all the categories that have been defined for the user.
|Get the properties and relationships of the specified outlookCategory object.
|Create an outlookCategory object in the user's master list of categories.
|Update the writable property, color, of the specified outlookCategory object.
|Delete the specified outlookCategory object.
|A pre-set color constant that characterizes a category, and that is mapped to one of 25 predefined colors. For more details, see the following note.
|A unique name that identifies a category in the user's mailbox. After a category is created, the name cannot be changed. Read-only.
Note The possible values for color are pre-set constants such as
preset1. Each pre-set constant is further mapped to a color; the actual color is dependent on the Outlook client that the categories are being displayed in. The following table shows the colors mapped to each pre-set constant for Outlook (desktop client).
|Color mapped to in Outlook
|No color mapped
The following is a JSON representation of the resource.