Skip to content
exonaut

organizationConfig

Organization Settings. Tenant-wide Exchange organization settings (Get/Set-OrganizationConfig). The organizationConfig singleton lives under /exchange/v1.0/organizationConfig in the Organization category.

Fact Value
Path /exchange/v1.0/organizationConfig
Category Organization
Tier Tier 9, Hybrid and organization
Read role OrganizationConfig.Read.All (Community)
Write role OrganizationConfig.ReadWrite.All (Enterprise)
Backing cmdlets Get-OrganizationConfig, Set-OrganizationConfig

Routes

Section titled “Routes”
Method Path Synopsis Role Plan
GET /exchange/v1.0/organizationConfig Read the tenant’s organizationConfig singleton. OrganizationConfig.Read Community
PATCH /exchange/v1.0/organizationConfig Partial update of the organizationConfig singleton via Set-OrganizationConfig. Body keys map 1:1 to cmdlet params (camelCased). Returns 200 + the post-Set entity. OrganizationConfig.ReadWrite Enterprise

GET /exchange/v1.0/organizationConfig

Section titled “GET /exchange/v1.0/organizationConfig”

Read the tenant’s organizationConfig singleton.

Backing cmdlet: Get-OrganizationConfig. Role: OrganizationConfig.Read (Community).

Get the organization configuration

Section titled “Get the organization configuration”

Returns the tenant-wide organization configuration singleton. Backed by the Get-OrganizationConfig cmdlet, this exposes Exchange Online org-level settings (MailTips, connectors, Bookings, EWS, public folder defaults, and more) for the single tenant.

GET /exchange/v1.0/organizationConfig HTTP/1.1
Authorization: Bearer {token}
HTTP/1.1 200 OK


{
  "@odata.context": "http://localhost:5043/exchange/v1.0/$metadata#organizationConfig",
  "Id": "First Organization",
  "Name": "contoso.onmicrosoft.com",
  "Identity": "contoso.onmicrosoft.com",
  "DisplayName": "Contoso Europe",
  "AdminDisplayName": null,
  "Guid": "174150b0-d379-4910-81b9-892946819341",
  "ExchangeObjectId": "f457e04f-4cba-4f82-accb-e766a81016f3",
  "OrganizationStatus": null,
  "IsDehydrated": false,
  "IsUpdatingServicePlan": false,
  "IsTenantAccessBlocked": false,
  "IsTenantInGracePeriod": false,
  "ServicePlan": "BPOS_S_E15_0",
  "CustomerFeedbackEnabled": null,
  "AdminAuditLogEnabled": false,
  "AdminAuditLogCmdlets": [],
  "AdminAuditLogParameters": [],
  "AdminAuditLogAgeLimit": 0,
  "UnifiedAuditLogIngestionEnabled": false,
  "UnifiedAuditLogFirstOptInDate": false,
  "AuditDisabled": "False",
  "ConnectorsEnabled": true,
  "ConnectorsActionableMessagesEnabled": true,
  "ConnectorsEnabledForOutlook": true,
  "ConnectorsEnabledForTeams": true,
  "ConnectorsEnabledForYammer": true,
  "ConnectorsEnabledForSharepoint": true,
  "SmtpActionableMessagesEnabled": true,
  "MailTipsAllTipsEnabled": true,
  "MailTipsGroupMetricsEnabled": true,
  "MailTipsLargeAudienceThreshold": 25,
  "MailTipsMailboxSourcedTipsEnabled": true,
  "MailTipsExternalRecipientsTipsEnabled": false,
  "DefaultGroupAccessType": "Private",
  "DefaultPublicFolderMailbox": null,
  "DistributionGroupDefaultOU": null,
  "DistributionGroupNameBlockedWordsList": [],
  "DistributionGroupNamingPolicy": "",
  "EnableForwardingAddress": false,
  "OutlookGifPickerDisabled": false,
  "BookingsEnabled": true,
  "BookingsAddressEntryRestricted": false,
  "BookingsNamingPolicyEnabled": false,
  "BookingsCreationOfCustomQuestionsRestricted": false,
  "OAuth2ClientProfileEnabled": true,
  "ModernAuthServer": false,
  "MapiHttpEnabled": false,
  "EwsEnabled": false,
  "EwsApplicationAccessPolicy": null,
  "EwsAllowList": [],
  "EwsBlockList": [],
  "MicrosoftExchangeRecipientPrimarySmtpAddress": "MicrosoftExchange329e71ec88ae4615bbc36ab6ce41109e@contoso.onmicrosoft.com",
  "MicrosoftExchangeRecipientReplyRecipient": null,
  "MicrosoftExchangeRecipientEmailAddresses": [
    "SMTP:MicrosoftExchange329e71ec88ae4615bbc36ab6ce41109e@contoso.onmicrosoft.com"
  ],
  "ActivityBasedAuthenticationTimeoutEnabled": true,
  "ActivityBasedAuthenticationTimeoutInterval": "PT6H",
  "AzureADCheckpointPolicy": null,
  "AuthenticationPolicy": null,
  "ReadTrackingEnabled": false,
  "WorkspaceTenantEnabled": true,
  "VivaInsightsWebExperienceEnabled": false,
  "ExchangeNotificationEnabled": true,
  "VoltageSecureMailEnabled": false,
  "ElcProcessingDisabled": false,
  "HierarchicalAddressBookRoot": false,
  "WebPushNotificationsDisabled": false,
  "WebSuggestedRepliesDisabled": false,
  "SiteMailboxCreationURL": null,
  "OrganizationalUnitRoot": "contoso.onmicrosoft.com",
  "OrganizationId": "EURPR01A017.PROD.OUTLOOK.COM/Microsoft Exchange Hosted Organizations/contoso.onmicrosoft.com - EURPR01A017.PROD.OUTLOOK.COM/ConfigurationUnits/contoso.onmicrosoft.com/Configuration",
  "ExchangeVersion": "0.1 (8.0.535.0)",
  "ObjectCategory": "EURPR01A017.PROD.OUTLOOK.COM/Configuration/Schema/ms-Exch-Configuration-Unit-Container",
  "ObjectClass": [
    "top",
    "container",
    "msExchOrganizationContainer",
    "msExchConfigurationUnitContainer"
  ],
  "OriginatingServer": "VI1PR01A17DC001.EURPR01A017.PROD.OUTLOOK.COM",
  "ObjectState": "Changed",
  "IsValid": true,
  "WhenCreated": "2026-03-30T16:48:56+03:00",
  "WhenChanged": "2026-05-29T10:43:53+03:00",
  "WhenCreatedUTC": "2026-03-30T13:48:56Z",
  "WhenChangedUTC": "2026-05-29T07:43:53Z",
  "ACLableSyncedObjectEnabled": false,
  "AVAuthenticationService": null,
  "AbacFeatureEnabled": false,
  "ActionableMessagesExtenalAccessTokenEnabled": false,
  "ActivityBasedAuthenticationTimeoutWithSingleSignOnEnabled": true,
  "AdfsAudienceUris": [],
  "AdfsAuthenticationConfiguration": "",
  "AdfsEncryptCertificateThumbprint": null,
  "AdfsIssuer": null,
  "AdfsSignCertificateThumbprints": [],
  "AdminDisplayVersion": "0.20 (15.21.71.12)",
  "AllowToAddGuests": true,
  "AllowedMailboxRegions": "eur=eurprd02.prod.outlook.com EUR.Sub=eurp189.prod.outlook.com,eurp194.prod.outlook.com,eurprd01.prod.exchangelabs.com,eurprd02.prod.outlook.com",
  "AllowedMailboxRegionsLastUpdateTime": "2026-02-21T12:01:02Z",
  "AppsForOfficeCorpCatalogAppsCount": 0,
  "AppsForOfficeEnabled": true,
  "AsyncSendEnabled": true,
  "AutoArchivingThresholdPercentage": 96,
  "AutoEnableArchiveMailbox": false,
  "AutoExpandingArchiveEnabled": false,
  "AutoJitForests": null,
  "AutodiscoverPartialDirSync": false,
  "AutomaticForcedReadReceiptEnabled": false,
  "AzurePremiumSubscriptionStatus": false,
  "BasicAuthBlockedApps": "767",
  "BlockExchangeProvisioningFromOnPremEnabled": false,
  "BlockMoveMessagesForGroupFolders": false,
  "BookingsAuthEnabled": false,
  "BookingsBlockedWordsEnabled": false,
  "BookingsEnabledLastUpdateTime": "0001-01-01T00:00:00Z",
  "BookingsExposureOfStaffDetailsRestricted": false,
  "BookingsMembershipApprovalRequired": false,
  "BookingsNamingPolicyPrefix": "",
  "BookingsNamingPolicyPrefixEnabled": false,
  "BookingsNamingPolicySuffix": "",
  "BookingsNamingPolicySuffixEnabled": false,
  "BookingsNotesEntryRestricted": false,
  "BookingsPaymentsEnabled": false,
  "BookingsPhoneNumberEntryRestricted": false,
  "BookingsSearchEngineIndexDisabled": false,
  "BookingsSmsMicrosoftEnabled": true,
  "BookingsSocialSharingRestricted": false,
  "ByteEncoderTypeFor7BitCharsets": 0,
  "CompassEnabled": null,
  "ComplianceMLBgdCrawlEnabled": false,
  "ConnectorsEnabledForOutlookLastUpdateTime": "0001-01-01T00:00:00Z",
  "ConnectorsEnabledForSharepointLastUpdateTime": "0001-01-01T00:00:00Z",
  "ConnectorsEnabledForTeamsLastUpdateTime": "0001-01-01T00:00:00Z",
  "ConnectorsEnabledForYammerLastUpdateTime": "0001-01-01T00:00:00Z",
  "CurrentMailboxForests": "eurprd02.prod.outlook.com eurp189.prod.outlook.com eurp194.prod.outlook.com eurprd01.prod.exchangelabs.com",
  "CustomerLockboxEnabled": false,
  "DLPViaDcsEnabled": false,
  "DLPWaitOnSendEnabled": false,
  "DLPWaitOnSendTimeout": 9999,
  "DataClassifications": "<DataClassifications />",
  "DataInsightsFlag": 4093640694,
  "DefaultAuthenticationPolicy": null,
  "DefaultDataEncryptionPolicy": null,
  "DefaultFolderPermissionRestricted": false,
  "DefaultMailboxRegion": "eur",
  "DefaultMailboxRegionLastUpdateTime": "2023-09-20T08:15:07.0348816Z",
  "DefaultMinutesToReduceLongEventsBy": 10,
  "DefaultMinutesToReduceShortEventsBy": 5,
  "DefaultPublicFolderAgeLimit": null,
  "DefaultPublicFolderDeletedItemRetention": "30.00:00:00",
  "DefaultPublicFolderIssueWarningQuota": "1.7 GB (1,825,361,920 bytes)",
  "DefaultPublicFolderMaxItemSize": "Unlimited",
  "DefaultPublicFolderMovedItemRetention": "7.00:00:00",
  "DefaultPublicFolderProhibitPostQuota": "2 GB (2,147,483,648 bytes)",
  "DelayedDelicensingBlockedExplicitlyState": "Enabled: False; WhenLastModifiedUtc: 1/1/0001 12:00:00 AM",
  "DelayedDelicensingEnabledState": "Enabled: False; WhenLastModifiedUtc: 1/1/0001 12:00:00 AM",
  "DirectReportsGroupAutoCreationEnabled": false,
  "DisableMailboxForSubstrateOnlyFinished": false,
  "DisablePlusAddressInRecipients": false,
  "DistinguishedName": "CN=Configuration,CN=contoso.onmicrosoft.com,CN=ConfigurationUnits,DC=EURPR01A017,DC=PROD,DC=OUTLOOK,DC=COM",
  "ElevatedAccessControl": "Enabled:True; Mode:PartnerExecuteOnly; AdminGroup:; ApprovalPolicyCount:0; SystemAccounts:; NotificationMailbox:SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}@contoso.onmicrosoft.com",
  "EnableForwardingAddressSyncForMailboxes": false,
  "EnableOutlookEvents": false,
  "EndUserDLUpgradeFlowsDisabled": false,
  "EndUserMailNotificationForDelayedDelicensingState": "Enabled: False; WhenLastModifiedUtc: 1/1/0001 12:00:00 AM",
  "EnforceExoAppRbacPermissions": false,
  "EnforceShortenEventSettingEffectiveTime": null,
  "EwsAllowEntourage": null,
  "EwsAllowMacOutlook": null,
  "EwsAllowOutlook": null,
  "EwsAllowedAppIDs": "",
  "EwsOperationAccessPolicyAllowList": "",
  "EwsOperationAccessPolicyEnabled": null,
  "EwsOperationAccessPolicyPopulated": false,
  "ExchangeNotificationRecipients": [],
  "ExternalCloudAccessEnabled": false,
  "FindTimeAttendeeAuthenticationEnabled": false,
  "FindTimeAutoScheduleDisabled": false,
  "FindTimeLockPollForAttendeesEnabled": false,
  "FindTimeOnlineMeetingOptionDisabled": false,
  "FirstPartyTenantFlag": false,
  "FocusedInboxOn": null,
  "FocusedInboxOnLastUpdateTime": "0001-01-01T00:00:00Z",
  "ForeignForestFQDN": [],
  "ForeignForestOrgAdminUSGSid": null,
  "ForeignForestRecipientAdminUSGSid": null,
  "ForeignForestViewOnlyAdminUSGSid": null,
  "ForestConfigLastRunTime": "0001-01-01T00:00:00Z",
  "ForestConfigVersion": "",
  "ForwardSyncLiveIdBusinessInstance": false,
  "GroupLifeCyclePolicy": "<GroupLifeCyclePolicy><GroupLifetimeInDays>-1</GroupLifetimeInDays><ManagedGroupType p2:nil=\"true\" xmlns:p2=\"http://www.w3.org/2001/XMLSchema-instance\" /><LastUpdatedTime>2026-05-29T07:43:41.0200096Z</LastUpdatedTime></GroupLifeCyclePolicy>",
  "GroupsCreationEnabled": false,
  "GroupsCreationWhitelistedId": "",
  "GroupsNamingPolicy": "",
  "GroupsUsageGuidelinesLink": "",
  "GuestsEnabled": true,
  "GuestsUsageGuidelinesLink": "",
  "Heuristics": "None",
  "HiddenMembershipGroupsCreationEnabled": false,
  "HybridConfigurationStatus": "Unknown",
  "HybridRSVPEnabled": true,
  "IPListBlocked": [],
  "InPlaceHolds": [
    "mbxc9a93fafa2954c9fac8dc00964207353:2"
  ],
  "InRegionRoutingEnabled": false,
  "InRegionRoutingEnabledLastUpdateTime": null,
  "Industry": "NotSpecified",
  "InformationBarrierMode": "Legacy",
  "InformationBarriersEnforcementEnabled": false,
  "InformationBarriersManagementEnabled": false,
  "InformationBarriersRestrictPeopleSearch": true,
  "IntuneManagedStatus": true,
  "IsAddressListPagingEnabled": true,
  "IsAgendaMailEnabled": true,
  "IsAllowedToAccessRoamingFeature": true,
  "IsComplianceTrialEnabled": false,
  "IsDualWriteEnabled": true,
  "IsEopTrialEnabled": false,
  "IsExcludedFromOffboardMigration": false,
  "IsExcludedFromOnboardMigration": false,
  "IsFfoMigrationInProgress": false,
  "IsGroupFoldersAndRulesEnabled": false,
  "IsGroupMemberAllowedToEditContent": false,
  "IsGuidPrefixedLegacyDnDisabled": false,
  "IsJitEnabled": null,
  "IsLicensingEnforced": true,
  "IsMIPLabelForGroupsEnabled": true,
  "IsMailboxForcedReplicationDisabled": false,
  "IsMixedMode": true,
  "IsProcessEhaMigratedMessagesEnabled": false,
  "IsUpgradingOrganization": false,
  "LeanPopoutEnabled": false,
  "LegacyExchangeDN": "/o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=contoso.onmicrosoft.com/cn=Configuration",
  "LinkPreviewEnabled": true,
  "MailboxDataEncryptionEnabled": false,
  "ManagedFolderHomepage": "",
  "MaskClientIpInReceivedHeadersEnabled": true,
  "MatchSenderOrganizerProperties": false,
  "MaxAddressBookPolicies": null,
  "MaxConcurrentMigrations": "Unlimited",
  "MaxInformationBarrierBridges": 5000,
  "MaxInformationBarrierSegments": 5000,
  "MaxInformationBarrierSegmentsLegacy": null,
  "MaxOfflineAddressBooks": null,
  "MessageHighlightsEnabled": true,
  "MessageRecallAlertRecipientsEnabled": false,
  "MessageRecallAlertRecipientsReadMessagesOnlyEnabled": false,
  "MessageRecallEnabled": null,
  "MessageRecallMaxRecallableAge": "365.00:00:00",
  "MessageRemindersEnabled": true,
  "MicrosoftExchangeRecipientEmailAddressPolicyEnabled": false,
  "MimeTypes": [],
  "MobileAppEducationEnabled": true,
  "NetworkThrottlingConfiguration": null,
  "ObjectVersion": 16500,
  "OcmGroupId": null,
  "OfficeGraphActivitySharingOrgOptout": false,
  "OnlineMeetingsByDefaultEnabled": null,
  "OrganizationConfigHash": "jJFLTsQwDIavUnUFC/KoeGwyGY1ajYYNsAD2IXErS01SJenAcDUWHIkrkNINoDJiZfv3b3+W/PH2LtYvti/2ECJ6tyo5YWUBTnuDrluVY2rP+GW5lqKpd4engKb2rsVuDCplvxTXsVFJ1eASBHkfRhD0hyQ2xqJrMA69OjzOFMlIxYoTfkEqTq444dWpoEu+vP1h6IKabrkNnXL4OmO3qo9fpOW2uAuwRz/GZTif4OdkShhhmX3MLjZaw5DANN4qzPUcb5QFGVPrwIIyzwPR3gr6rfeXL4s98c6iDj76Nv178OgM/X0lXf7XJwAAAP//AwA=",
  "OrganizationPrivacyStatementLink": null,
  "OrganizationSummary": [],
  "OutlookMobileGCCRestrictionsEnabled": false,
  "OutlookMobileHelpShiftEnabled": true,
  "OutlookMobileSingleAccountEnabled": false,
  "OutlookPayEnabled": true,
  "OutlookTextPredictionDisabled": false,
  "PerTenantSwitchToESTSEnabled": false,
  "PostponeRoamingSignaturesUntilLater": false,
  "PreferredInternetCodePageForShiftJis": 0,
  "PreviousAdminDisplayVersion": "0.10 (14.0.100.0)",
  "PrivateCatalogAppsCount": 0,
  "PublicComputersDetectionEnabled": false,
  "PublicFolderMailboxesLockedForNewConnections": false,
  "PublicFolderMailboxesMigrationComplete": false,
  "PublicFolderMigrationComplete": false,
  "PublicFolderShowClientControl": false,
  "PublicFoldersEnabled": "Local",
  "PublicFoldersLockedForMigration": false,
  "RBACConfigurationVersion": "0.1 (15.21.71.12)",
  "RPSEnabled": true,
  "RealTimeLogServiceEnabled": false,
  "RecallReadMessagesEnabled": null,
  "RecipientDelimiters": true,
  "RefreshSessionEnabled": false,
  "RejectDirectSend": false,
  "ReleaseTrack": null,
  "RemotePublicFolderMailboxes": [],
  "RequiredCharsetCoverage": 100,
  "ResourceAddressLists": "\\All Rooms",
  "RmsoSubscriptionStatus": "Unknown",
  "RootPublicFolderMailbox": null,
  "SCLJunkThreshold": 4,
  "SIPAccessService": null,
  "SIPSessionBorderController": null,
  "SendFromAliasEnabled": false,
  "ServiceInstanceMove": null,
  "SharePointUrl": "https://contoso.sharepoint.com/",
  "SharedDomainEmailAddressFlowEnabled": true,
  "ShortenEventScopeDefault": "None",
  "TargetServicePlan": "",
  "TenantAdminNotificationForDelayedDelicensingState": "Enabled: False; WhenLastModifiedUtc: 1/1/0001 12:00:00 AM",
  "TenantRelocationsAllowed": false,
  "TwoClickMailPreviewEnabled": false,
  "UnblockUnsafeSenderPromptEnabled": true,
  "UpgradeIBInProgress": false,
  "VisibleMeetingUpdateProperties": "Location,AllProperties:15",
  "WACDiscoveryEndpoint": ""
}

Notes: Tenant singleton: the path takes no key and always returns exactly one object. Read-only here; org-level changes go through Set-OrganizationConfig.

PATCH /exchange/v1.0/organizationConfig

Section titled “PATCH /exchange/v1.0/organizationConfig”

Partial update of the organizationConfig singleton via Set-OrganizationConfig. Body keys map 1:1 to cmdlet params (camelCased). Returns 200 + the post-Set entity.

TENANT-WIDE impact - every mailbox in the tenant feels the effect of this PATCH. Practical use cases the allowlist supports: Bookings tenant defaults, EWS allow/block lists, MailTips toggles, Message Recall toggle, group naming + access defaults, Outlook web/mobile feature flags (GIF picker, text predictions, push notifications), activity-based auth timeouts, public folder pointers. The Wiki documents ~174 settable params on this cmdlet; the API exposes ~50 modern-cloud-applicable ones (see ). On-prem-leaning params (MapiHttp*, Hub*, RpcClient*, Database*) are intentionally omitted; they’d either silently no-op or fail at runtime on cloud-only tenants.Singleton PATCH - no URL key. Pass ?dryRun=true for a -WhatIf preview before changing a tenant-wide setting.

Backing cmdlet: Set-OrganizationConfig. Role: OrganizationConfig.ReadWrite (Enterprise).

Parameter In Type Required Description
actionableMessagesExtenalAccessTokenEnabled body
activityBasedAuthenticationTimeoutEnabled body
activityBasedAuthenticationTimeoutInterval body
activityBasedAuthenticationTimeoutWithSingleSignOnEnabled body
appsForOfficeEnabled body
asyncSendEnabled body
auditDisabled body
autoEnableArchiveMailbox body
autoExpandingArchive body boolean (switch)
blockMoveMessagesForGroupFolders body
bookingsAddressEntryRestricted body
bookingsAuthEnabled body
bookingsBlockedWordsEnabled body
bookingsCreationOfCustomQuestionsRestricted body
bookingsEnabled body
bookingsExposureOfStaffDetailsRestricted body
bookingsMembershipApprovalRequired body
bookingsNamingPolicyEnabled body
bookingsNamingPolicyPrefix body
bookingsNamingPolicyPrefixEnabled body
bookingsNamingPolicySuffix body
bookingsNamingPolicySuffixEnabled body
bookingsNotesEntryRestricted body
bookingsPaymentsEnabled body
bookingsPhoneNumberEntryRestricted body
bookingsSearchEngineIndexDisabled body
bookingsSmsMicrosoftEnabled body
bookingsSocialSharingRestricted body
connectorsActionableMessagesEnabled body
connectorsEnabled body
connectorsEnabledForOutlook body
connectorsEnabledForSharepoint body
connectorsEnabledForTeams body
connectorsEnabledForYammer body
defaultGroupAccessType body
defaultMinutesToReduceLongEventsBy body
defaultMinutesToReduceShortEventsBy body
delayedDelicensingEnabled body
directReportsGroupAutoCreationEnabled body
disablePlusAddressInRecipients body
distributionGroupDefaultOU body
distributionGroupNameBlockedWordsList body
distributionGroupNamingPolicy body
dlpWaitOnSendEnabled body
dlpWaitOnSendTimeout body
enableOutlookEvents body
endUserDLUpgradeFlowsDisabled body
endUserMailNotificationForDelayedDelicensingEnabled body
enforceShortenEventSetting body boolean (switch)
ewsAllowEntourage body
ewsAllowList body
ewsAllowMacOutlook body
ewsAllowOutlook body
ewsApplicationAccessPolicy body
ewsBlockList body
ewsEnabled body
exchangeNotificationEnabled body
exchangeNotificationRecipients body
findTimeAttendeeAuthenticationEnabled body
findTimeAutoScheduleDisabled body
findTimeLockPollForAttendeesEnabled body
findTimeOnlineMeetingOptionDisabled body
focusedInboxOn body
hierarchicalAddressBookRoot body
hybridRSVPEnabled body
ipListBlocked body
isGroupFoldersAndRulesEnabled body
isGroupMemberAllowedToEditContent body
leanPopoutEnabled body
linkPreviewEnabled body
mailTipsAllTipsEnabled body
mailTipsExternalRecipientsTipsEnabled body
mailTipsGroupMetricsEnabled body
mailTipsLargeAudienceThreshold body
mailTipsMailboxSourcedTipsEnabled body
maskClientIpInReceivedHeadersEnabled body
messageHighlightsEnabled body
messageRecallAlertRecipientsEnabled body
messageRecallAlertRecipientsReadMessagesOnlyEnabled body
messageRecallEnabled body
messageRecallMaxRecallableAge body
messageRemindersEnabled body
mobileAppEducationEnabled body
oAuth2ClientProfileEnabled body
onlineMeetingsByDefaultEnabled body
outlookGifPickerDisabled body
outlookMobileGCCRestrictionsEnabled body
outlookPayEnabled body
outlookTextPredictionDisabled body
postponeRoamingSignaturesUntilLater body
preferredInternetCodePageForShiftJis body
publicFolderShowClientControl body
recallReadMessagesEnabled body
rejectDirectSend body
sendFromAliasEnabled body
shortenEventScopeDefault body
smtpActionableMessagesEnabled body
tenantAdminNotificationForDelayedDelicensingEnabled body
twoClickMailPreviewEnabled body
visibleMeetingUpdateProperties body
webPushNotificationsDisabled body
webSuggestedRepliesDisabled body
workspaceTenantEnabled body
dryRun query bool (switch)

Update tenant-wide organization configuration

Section titled “Update tenant-wide organization configuration”

Partial update of the organizationConfig singleton via Set-OrganizationConfig. Body keys map 1:1 to cmdlet parameters (camelCased) and are tenant-wide in effect. Returns 200 plus the post-Set entity.

PATCH /exchange/v1.0/organizationConfig HTTP/1.1
Authorization: Bearer {token}
Content-Type: application/json


{
  "mailTipsAllTipsEnabled": true,
  "mailTipsLargeAudienceThreshold": 25,
  "focusedInboxOn": true
}
HTTP/1.1 200 OK
Content-Type: application/json


{
  "Identity": "contoso.com",
  "Name": "contoso.com",
  "MailTipsAllTipsEnabled": true,
  "MailTipsLargeAudienceThreshold": 25,
  "FocusedInboxOn": true
}

Notes: Doc-derived from Wiki + write-param allowlist; not live-captured. Body fields are Wiki-valid; values are illustrative.

Related: GET /exchange/v1.0/organizationConfig

?dryRun=true previews of any write stay on Community.