organization resource type

Represents an Azure Active Directory tenant. Only the read and update operations are supported on tenants; create and delete are not supported. Inherits from directoryObject.

This resource lets you add your own data to custom properties using extensions.

Methods

Method Return Type Description
Get organization organization Read properties and relationships of organization object.
Update organization Update organization object. (Only the marketingNotificationMails and technicalNotificationMails properties can be updated.)
Open extensions
Create open extension openTypeExtension Create an open extension and add custom properties to a new or existing resource.
Get open extension openTypeExtension collection Get an open extension identified by the extension name.
Schema extensions
Add schema extension values Create a schema extension definition and then use it to add custom typed data to a resource.

Properties

Property Type Description
assignedPlans assignedPlan collection The collection of service plans associated with the tenant. Not nullable.
city String
companyLastDirSyncTime DateTimeOffset The time and date at which the tenant was last synced with the on-premise directory.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
country String
countryLetterCode String
deletionTimestamp DateTimeOffset The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
dirSyncEnabled Boolean true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default).
displayName String The display name for the tenant.
id String The unique identifier for the tenant. Inherited from directoryObject. Key. Not nullable. Read-only.
marketingNotificationEmails String collection Not nullable.
objectType String A string that identifies the object type. For tenants the value is always “Company”.
postalCode String
preferredLanguage String
provisionedPlans ProvisionedPlan collection Not nullable.
provisioningErrors ProvisioningError collection Not nullable.
securityComplianceNotificationMails String collection
securityComplianceNotificationPhones String collection
state String
street String
technicalNotificationMails String collection Not nullable.
telephoneNumber String
verifiedDomains VerifiedDomain collection The collection of domains associated with this tenant. Not nullable.

Relationships

Relationship Type Description
extensions extension collection The collection of open extensions defined for the organization. Read-only. Nullable.

JSON representation

Here is a JSON representation of the resource

{
  "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
  "businessPhones": ["string"],
  "city": "string",
  "country": "string",
  "countryLetterCode": "string",
  "displayName": "string",
  "id": "string (identifier)",
  "marketingNotificationEmails": ["string"],
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSyncEnabled": true,
  "postalCode": "string",
  "preferredLanguage": "string",
  "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
  "securityComplianceNotificationMails": ["string"],
  "securityComplianceNotificationPhones": ["string"],
  "state": "string",
  "street": "string",
  "technicalNotificationMails": ["string"],
  "verifiedDomains": [{"@odata.type": "microsoft.graph.verifiedDomain"}]
}

See also