Modifica

distributionList resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a personal distribution list in the user's mailbox. A distribution list enables users to group email recipients together so they can send a message to all members at once, without entering each address individually.

Inherits from outlookItem.

Methods

Method Return type Description
List distributionList collection Get a list of the distributionList objects in the user's mailbox.
Create distributionList Create a new distributionList in the user's mailbox.
Get distributionList Read the properties and relationships of a distributionList object.
Update distributionList Update the properties of a distributionList object.
Delete None Delete a distributionList object.
Add members distributionList Add members to a distributionList.
Delete members distributionList Remove members from a distributionList.

Properties

Property Type Description
categories String collection The categories associated with the distribution list. Inherited from outlookItem.
changeKey String Version identifier used for optimistic concurrency control via the If-Match header. Read-only. Inherited from outlookItem.
createdDateTime DateTimeOffset The date and time when the distribution list was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z. Read-only. Inherited from outlookItem.
displayName String The display name of the distribution list.
id String The unique identifier for the distribution list. Read-only. Inherited from outlookItem.
lastModifiedDateTime DateTimeOffset The date and time when the distribution list was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z. Read-only. Inherited from outlookItem.
notes String Notes about the distribution list.
personIdentifier String The unique identifier of the distribution list in the mailbox. Read-only.

Relationships

Relationship Type Description
members distributionListMember collection The members of the distribution list. Not returned by default; use $expand=members to include. Read-only.
singleValueExtendedProperties singleValueLegacyExtendedProperty collection The collection of single-value extended properties defined for the distribution list. Read-only.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.distributionList",
  "id": "string (identifier)",
  "createdDateTime": "string (timestamp)",
  "lastModifiedDateTime": "string (timestamp)",
  "changeKey": "string",
  "categories": [
    "string"
  ],
  "displayName": "string",
  "notes": "string",
  "personIdentifier": "string"
}
  • Last updated on