Skip to content

Email Accounts

All operations require authentication.

50 operationsv1/email/exchange · /msServices/{serviceName}
Agent setup

List email accountsProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account

List email accounts. Returns the primary email addresses of the email accounts. Filter them by primaryEmailAddress, id, accountLicense or company.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

Query parameters

accountLicense
OvhLicenceEnum

Filter the value of accountLicense property (=)

Valuesbasicenterprisestandard
company
string

Filter the value of company property (like)

id
integer

Filter the value of id property (like)

primaryEmailAddress
string

Filter the value of primaryEmailAddress property (like)

Response

200string[]successful operation

Example uses exchangeService = string, organizationName = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ "string"]

Get an email accountProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}

Get an email account. Returns the login, names, license, quota, usage, state, spam settings, forwarding, litigation hold and contact details of the email account.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200Accountsuccessful operation
SAMAccountName
read-only
string

SAM account name

accountLicense
OvhLicenceEnum

Exchange account type

Valuesbasicenterprisestandard
authenticationPolicyId
integer

ID of the authentication policy to apply on this account

city
string

city

company
string

Company name

configured
read-only
boolean

Indicates if the account is configured

countryCode
CountryCodeEnum

Country code

ValuesACADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDGDJDKDMDODZEAECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHNHRHTHUICIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTATCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSXKYEYTZAZMZW
creationDate
read-only
stringdate-time

Creation date

currentUsage
read-only
integer

Mailbox usage

customIsolationId
read-only
integer

custom isolation apply on this account

deleteAtExpiration
boolean

delete at expiration

deleteOutlookAtExpiration
boolean

delete outlook at expiration

description
string

Description

displayName
string

Account display name

domain
string

Email domain

exchangeGuid
read-only
string

exchangeGuid for manual configuration

expirationDate
read-only
stringdate-time

expiration date

expirationOutlookDate
read-only
stringdate-time

expiration date

fax
phoneNumber

Fax number

firstName
string

Account first name

forwardingEmail
string

Email address to forward email

guid
read-only
string

GUID for user in active directory

hiddenFromGAL
boolean

Hide account in Global Address List

id
read-only
integer

Account id

initial
string

Account initials

jobDepartment
string

Job Department

jobTitle
string

Job title

lastLogoffDate
read-only
stringdate-time

Last logoff

lastLogonDate
read-only
stringdate-time

Last logon

lastName
string

Account last name

lastUpdateDate
read-only
stringdate-time

Last update

litigation
boolean

Litigation hold feature enabled on this mailbox

litigationPeriod
integer

Litigation hold period in days (0 means unlimited). This setting covers all items in the mailbox.

login
string

Account login

mailSenderDisplay
string

Email display as sender

mailingFilter
MailingFilterEnum[]

Enable or disable anti-virus and anti-spam

Valuesvaderetro
mobile
phoneNumber

Mobile phone

numberOfAliases
read-only
integer

Count the number of related aliases attached to this account

office
string

Job office

outlookLicense
boolean

Outlook licence

owaLimited
read-only
boolean

OWA policy restriction is applied

passwordLastUpdate
read-only
stringdate-time

Time of account's password last update

phone
phoneNumber

Phone number

postalCode
string

Postal code

primaryEmailAddress
read-only
string

Default email for this mailbox

quota
integer

Account maximum size

region
string

region

renewOutlookPeriod
renewPeriodEnum

change the renew period for outlook

Valuesmonthlyyearly
renewPeriod
renewPeriodEnum

change the renew period

Valuesmonthlyyearly
sbrDestination
string

Relay domain address that will be used to all e-mails send from this account

sendConnectorId
integer

Custom sendConnectorId used to send mails when SBR is configured

spamAndVirusConfiguration
spamAndVirusConfiguration

Spam and Antivirus configuration

spamDetected
read-only
boolean

Account was sending spam

spamTicketNumber
read-only
integer

Ticket number of spam detection

state
read-only
ObjectStateEnum

Account state

ValuescreatingdeletinginternalMigrationokreopeningsuspendedsuspending
storeCopyOfEmail
boolean

Store copy of email when forward is enable

streetAddress
string

Street address

taskPendingId
read-only
integer

Pending task for this account

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "SAMAccountName": "string", "accountLicense": "basic", "authenticationPolicyId": 0, "city": "string", "company": "string", "configured": true, "countryCode": "AC", "creationDate": "2024-01-01T12:00:00Z", "currentUsage": 0, "customIsolationId": 0, "deleteAtExpiration": true, "deleteOutlookAtExpiration": true, "description": "string", "displayName": "string", "domain": "string", "exchangeGuid": "string", "expirationDate": "2024-01-01T12:00:00Z", "expirationOutlookDate": "2024-01-01T12:00:00Z", "fax": "string", "firstName": "string", "forwardingEmail": "string", "guid": "string", "hiddenFromGAL": true, "id": 0, "initial": "string", "jobDepartment": "string", "jobTitle": "string", "lastLogoffDate": "2024-01-01T12:00:00Z", "lastLogonDate": "2024-01-01T12:00:00Z", "lastName": "string", "lastUpdateDate": "2024-01-01T12:00:00Z", "litigation": true, "litigationPeriod": 0, "login": "string", "mailSenderDisplay": "string", "mailingFilter": [ "vaderetro" ], "mobile": "string", "numberOfAliases": 0, "office": "string", "outlookLicense": true, "owaLimited": true, "passwordLastUpdate": "2024-01-01T12:00:00Z", "phone": "string", "postalCode": "string", "primaryEmailAddress": "string", "quota": 0, "region": "string", "renewOutlookPeriod": "monthly", "renewPeriod": "monthly", "sbrDestination": "string", "sendConnectorId": 0, "spamAndVirusConfiguration": { "checkDKIM": true, "checkSPF": true, "deleteSpam": true, "deleteVirus": true, "putInJunk": true, "tagSpam": true, "tagVirus": true }, "spamDetected": true, "spamTicketNumber": 0, "state": "creating", "storeCopyOfEmail": true, "streetAddress": "string", "taskPendingId": 0}

Create an email accountProduction

POST
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account

Create an email account. Creates an email account from a login, a domain, a password and a license, and returns the task. Set quota in GB.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

Request body (required)

SAMAccountName
string

SAM account name (exchange 2010 login)

authenticationPolicyId
integer

ID of the authentication policy

city
string

City

company
string

Company name

countryCode
CountryCodeEnum

Country code

ValuesACADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDGDJDKDMDODZEAECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHNHRHTHUICIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTATCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSXKYEYTZAZMZW
description
string

Description

displayName
string

Account display name

domain
required
string

Email domain

fax
phoneNumber

Fax number

firstName
string

Account first name

forwardingEmail
string

Email address to forward email

hiddenFromGAL
boolean

Hide the account in Global Address List

initials
string

Account initials

jobDepartment
string

Job department

jobTitle
string

Job title

lastName
string

Account last name

license
required
OvhLicenceEnum

Exchange license

Valuesbasicenterprisestandard
litigation
boolean

Litigation status

litigationPeriod
integer

Litigation length in days, 0 means unlimited

login
required
string

Account login

mailSenderDisplay
string

Email display as sender

mailingFilter
MailingFilterEnum[]

Enable mailing filtrering

Valuesvaderetro
mobile
phoneNumber

Mobile phone number

office
string

office

outlookLicense
boolean

Buy outlook license

password
required
stringpassword

Account password

phone
phoneNumber

Phone Number

postalCode
string

Postal code

quota
integer

Quota specified in GB. Check pricing table before use

region
string

Region

sbrDestination
string

Sender base routing destination domain

sendConnectorId
integer

Send connector id used to send mails when SBR is defined

spamAndVirusConfiguration
spamAndVirusConfiguration

Antispam and Antivirus configuration

storeCopyOfEmail
boolean

Store copy of email when forward is enable

streetAddress
string

Street address

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Delete an email accountProduction

DELETE
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}

Delete an email account. Deletes the email account and returns the task. On Hosted Exchange, the account is reset instead: its content is deleted and it becomes an unconfigured slot in configureme.me that keeps its subscription.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Update an email accountProduction

PUT
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}

Update an email account. Updates the names, license, quota, renewal, forwarding, litigation hold, spam settings, authentication policy and contact details of the email account.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Request body (required)

SAMAccountName
read-only
string

SAM account name

accountLicense
OvhLicenceEnum

Exchange account type

Valuesbasicenterprisestandard
authenticationPolicyId
integer

ID of the authentication policy to apply on this account

city
string

city

company
string

Company name

configured
read-only
boolean

Indicates if the account is configured

countryCode
CountryCodeEnum

Country code

ValuesACADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDGDJDKDMDODZEAECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHNHRHTHUICIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTATCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSXKYEYTZAZMZW
creationDate
read-only
stringdate-time

Creation date

currentUsage
read-only
integer

Mailbox usage

customIsolationId
read-only
integer

custom isolation apply on this account

deleteAtExpiration
boolean

delete at expiration

deleteOutlookAtExpiration
boolean

delete outlook at expiration

description
string

Description

displayName
string

Account display name

domain
string

Email domain

exchangeGuid
read-only
string

exchangeGuid for manual configuration

expirationDate
read-only
stringdate-time

expiration date

expirationOutlookDate
read-only
stringdate-time

expiration date

fax
phoneNumber

Fax number

firstName
string

Account first name

forwardingEmail
string

Email address to forward email

guid
read-only
string

GUID for user in active directory

hiddenFromGAL
boolean

Hide account in Global Address List

id
read-only
integer

Account id

initial
string

Account initials

jobDepartment
string

Job Department

jobTitle
string

Job title

lastLogoffDate
read-only
stringdate-time

Last logoff

lastLogonDate
read-only
stringdate-time

Last logon

lastName
string

Account last name

lastUpdateDate
read-only
stringdate-time

Last update

litigation
boolean

Litigation hold feature enabled on this mailbox

litigationPeriod
integer

Litigation hold period in days (0 means unlimited). This setting covers all items in the mailbox.

login
string

Account login

mailSenderDisplay
string

Email display as sender

mailingFilter
MailingFilterEnum[]

Enable or disable anti-virus and anti-spam

Valuesvaderetro
mobile
phoneNumber

Mobile phone

numberOfAliases
read-only
integer

Count the number of related aliases attached to this account

office
string

Job office

outlookLicense
boolean

Outlook licence

owaLimited
read-only
boolean

OWA policy restriction is applied

passwordLastUpdate
read-only
stringdate-time

Time of account's password last update

phone
phoneNumber

Phone number

postalCode
string

Postal code

primaryEmailAddress
read-only
string

Default email for this mailbox

quota
integer

Account maximum size

region
string

region

renewOutlookPeriod
renewPeriodEnum

change the renew period for outlook

Valuesmonthlyyearly
renewPeriod
renewPeriodEnum

change the renew period

Valuesmonthlyyearly
sbrDestination
string

Relay domain address that will be used to all e-mails send from this account

sendConnectorId
integer

Custom sendConnectorId used to send mails when SBR is configured

spamAndVirusConfiguration
spamAndVirusConfiguration

Spam and Antivirus configuration

spamDetected
read-only
boolean

Account was sending spam

spamTicketNumber
read-only
integer

Ticket number of spam detection

state
read-only
ObjectStateEnum

Account state

ValuescreatingdeletinginternalMigrationokreopeningsuspendedsuspending
storeCopyOfEmail
boolean

Store copy of email when forward is enable

streetAddress
string

Street address

taskPendingId
read-only
integer

Pending task for this account

Response

200—successful operation

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress} \
  -H "authorization: Bearer $OVH_TOKEN"

Get the archive mailboxProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/archive

Get the archive mailbox. Returns the quota in GB, the usage, the state and the creation date of the archive mailbox.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200exchangeAccountArchivesuccessful operation
creationDate
read-only
stringdate-time

Creation date

currentUsage
read-only
integer

Archive mailbox usage

guid
read-only
string

GUID of archive mailbox

quota
integer

Archive mailbox maximum size in GB

state
read-only
ObjectStateEnum

Archive mailbox state

ValuescreatingdeletinginternalMigrationokreopeningsuspendedsuspending
taskPendingId
read-only
integer

Pending task for this archive mailbox

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/archive \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "creationDate": "2024-01-01T12:00:00Z", "currentUsage": 0, "guid": "string", "quota": 0, "state": "creating", "taskPendingId": 0}

Create an archive mailboxProduction

POST
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/archive

Create an archive mailbox. Creates the archive mailbox of the email account and returns the task. Without quota, the archive gets the quota of the mailbox.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Request body (required)

quota
integer

Archive mailbox quota (if not provided mailbox quota will be taken)

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/archive \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Delete the archive mailboxProduction

DELETE
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/archive

Delete the archive mailbox. Deletes the archive mailbox of the email account with the emails archived in it, and returns the task.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/archive \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Update the archive mailbox quotaProduction

PUT
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/archive

Update the archive mailbox quota. Sets the maximum size of the archive mailbox of the email account (quota, in GB).

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Request body (required)

creationDate
read-only
stringdate-time

Creation date

currentUsage
read-only
integer

Archive mailbox usage

guid
read-only
string

GUID of archive mailbox

quota
integer

Archive mailbox maximum size in GB

state
read-only
ObjectStateEnum

Archive mailbox state

ValuescreatingdeletinginternalMigrationokreopeningsuspendedsuspending
taskPendingId
read-only
integer

Pending task for this archive mailbox

Response

200—successful operation

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/archive \
  -H "authorization: Bearer $OVH_TOKEN"

Change an email account passwordProduction

POST
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/changePassword

Change an email account password. Changes the password and returns the task. Set forcePasswordChangeAtNextLogon to make the user change it at the next logon.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Request body (required)

forcePasswordChangeAtNextLogon
boolean

The password will need to be changed at the next time you log on

password
stringpassword

New password

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/changePassword \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Get the PST exportProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/export

Get the PST export. Returns the creation date and the completion percentage of the PST export of the email account.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200Exportsuccessful operation
creationDate
read-only
stringdate-time

Creation date

percentComplete
read-only
integer

Percentage of export PST request completion

taskPendingId
read-only
integer

Task pending id

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/export \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "creationDate": "2024-01-01T12:00:00Z", "percentComplete": 0, "taskPendingId": 0}

Request a PST exportProduction

POST
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/export

Request a PST export. Starts the export of the email account to a PST file, and returns the task. Follow its progress in percentComplete.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/export \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Delete the PST exportProduction

DELETE
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/export

Delete the PST export. Deletes the PST file exported from the email account and its download URL, and returns the task.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/export \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Get the PST export URLProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/exportURL

Get the PST export URL. Returns the temporary URL to download the PST export of the email account, and its expiration date.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200ExportUrlsuccessful operation
expiration
read-only
stringdate-time

Url expiration date

url
read-only
string

Export url

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/exportURL \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "expiration": "2024-01-01T12:00:00Z", "url": "string"}

Generate a PST export URLProduction

POST
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/exportURL

Generate a PST export URL. Generates a temporary URL to download the PST export of the email account, and returns the task.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/exportURL \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Get the Outlook download URLProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/outlookURL

Get the Outlook download URL. Returns the temporary Outlook download URL, its expiration date and the license serial number.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200OutlookUrlsuccessful operation
expiration
read-only
stringdate-time

Url expiration date

serial
read-only
string

Serial number

url
read-only
string

Outlook url

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/outlookURL \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "expiration": "2024-01-01T12:00:00Z", "serial": "string", "url": "string"}

Generate an Outlook download URLProduction

POST
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/outlookURL

Generate an Outlook download URL. Generates a temporary Outlook download URL for the given version and language, and returns the task. The email account needs an Outlook license.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Request body (required)

language
required
LanguageEnum

Language of outlook

Valuesarbgczdadeelenesetfifrhehrhuidinitjakokzltlvmsnbnlplptpt-BRrorsruskslsvthtrukvizh-CN
version
required
OutlookVersionEnum

Version of outlook

Valuesmac_x86_2016mac_x86_2019mac_x86_2021windows_x64_2016windows_x64_2019windows_x64_2021windows_x86_2016windows_x86_2019windows_x86_2021

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/outlookURL \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Get the account protocolsProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/protocol

Get the account protocols. Returns whether POP, IMAP, webmail and ActiveSync are enabled on the email account.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200exchangeAccountProtocolsuccessful operation
IMAP
boolean

IMAP protocol enabled on that mailbox

POP
boolean

POP protocol enabled on that mailbox

activeSync
boolean

Mobile access enabled on that mailbox

creationDate
read-only
stringdate-time

Creation date

lastUpdate
read-only
stringdate-time

Last update date

taskPendingId
read-only
integer

Pending task id

webMail
boolean

Web mail enabled on that mailbox

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/protocol \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "IMAP": true, "POP": true, "activeSync": true, "creationDate": "2024-01-01T12:00:00Z", "lastUpdate": "2024-01-01T12:00:00Z", "taskPendingId": 0, "webMail": true}

Update the account protocolsProduction

PUT
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/protocol

Update the account protocols. Enables or disables POP, IMAP, webmail and ActiveSync on the email account.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Request body (required)

IMAP
boolean

IMAP protocol enabled on that mailbox

POP
boolean

POP protocol enabled on that mailbox

activeSync
boolean

Mobile access enabled on that mailbox

creationDate
read-only
stringdate-time

Creation date

lastUpdate
read-only
stringdate-time

Last update date

taskPendingId
read-only
integer

Pending task id

webMail
boolean

Web mail enabled on that mailbox

Response

200—successful operation

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/protocol \
  -H "authorization: Bearer $OVH_TOKEN"

Terminate an email account at expirationProduction

POST
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/terminate

Terminate an email account at expiration. Sets the email account to be suspended at its expiration date, and returns a message giving that date. Set deleteAtExpiration to false on the account to cancel.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200stringsuccessful operation

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/terminate \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
"string"

List account aliasesProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/alias

List account aliases. Returns the aliases of the email account: extra addresses that deliver to the same mailbox.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200string[]successful operation

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/alias \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ "string"]

Get an account aliasProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/alias/{alias}

Get an account alias. Returns the alias address, its creation date and the ID of its pending task, if any (taskPendingId).

Path parameters

alias
required
string

Alias

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200exchangeAccountAliassuccessful operation
alias
read-only
string

Alias

creationDate
read-only
stringdate-time

Creation date

taskPendingId
read-only
integer

Pending task id

Example uses alias = string, exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/alias/{alias} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "alias": "string", "creationDate": "2024-01-01T12:00:00Z", "taskPendingId": 0}

Create an account aliasProduction

POST
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/alias

Create an account alias. Adds the alias address to the email account, so that it receives its emails, and returns the task.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Request body (required)

alias
required
string

Alias

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/alias \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Delete an account aliasProduction

DELETE
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/alias/{alias}

Delete an account alias. Removes the alias address from the email account, which no longer receives its emails, and returns the task.

Path parameters

alias
required
string

Alias

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses alias = string, exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/alias/{alias} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

List full access permissionsProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/fullAccess

List full access permissions. Returns the IDs of the accounts that have full access to the email account.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200integer[]successful operation

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/fullAccess \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ 0]

Get a full access permissionProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/fullAccess/{allowedAccountId}

Get a full access permission. Returns the ID of the account allowed to open the mailbox of this email account, and the creation date of the right.

Path parameters

allowedAccountId
required
integer

Account id to give full access

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200exchangeAccountFullAccesssuccessful operation
allowedAccountId
read-only
integer

Account id to give full access

creationDate
read-only
stringdate-time

Creation date

taskPendingId
read-only
integer

Pending task id

Example uses allowedAccountId = 0, exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/fullAccess/{allowedAccountId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "allowedAccountId": 0, "creationDate": "2024-01-01T12:00:00Z", "taskPendingId": 0}

Add a full access permissionProduction

POST
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/fullAccess

Add a full access permission. Gives the account given by allowedAccountId full access to the email account, and returns the task.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Request body (required)

allowedAccountId
required
integer

User to give full access

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/fullAccess \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Remove a full access permissionProduction

DELETE
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/fullAccess/{allowedAccountId}

Remove a full access permission. Withdraws the access of the allowed account to the mailbox of this email account, and returns the task.

Path parameters

allowedAccountId
required
integer

Account id to give full access

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses allowedAccountId = 0, exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/fullAccess/{allowedAccountId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

List send as permissionsProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendAs

List send as permissions. Returns the IDs of the accounts allowed to send emails as the email account.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200integer[]successful operation

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendAs \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ 0]

Get a send as permissionProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendAs/{allowedAccountId}

Get a send as permission. Returns the ID of the account allowed to send emails as this email account, and the creation date of the right.

Path parameters

allowedAccountId
required
integer

Account id to give send as

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200exchangeAccountSendAssuccessful operation
allowedAccountId
read-only
integer

Account id to give send as

creationDate
read-only
stringdate-time

Creation date

taskPendingId
read-only
integer

Pending task id

Example uses allowedAccountId = 0, exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendAs/{allowedAccountId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "allowedAccountId": 0, "creationDate": "2024-01-01T12:00:00Z", "taskPendingId": 0}

Add a send as permissionProduction

POST
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendAs

Add a send as permission. Allows the account given by allowAccountId to send emails as the email account, and returns the task.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Request body (required)

allowAccountId
required
integer

Account id to allow to send mails from this mailbox

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendAs \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Remove a send as permissionProduction

DELETE
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendAs/{allowedAccountId}

Remove a send as permission. Withdraws the right of the allowed account to send emails as this email account, and returns the task.

Path parameters

allowedAccountId
required
integer

Account id to give send as

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses allowedAccountId = 0, exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendAs/{allowedAccountId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

List send on behalf permissionsProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendOnBehalfTo

List send on behalf permissions. Returns the IDs of the accounts allowed to send emails on behalf of the email account.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200integer[]successful operation

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendOnBehalfTo \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ 0]

Get a send on behalf permissionProduction

GET
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendOnBehalfTo/{allowedAccountId}

Get a send on behalf permission. Returns the ID of the account allowed to send emails on behalf of this email account, and the creation date of the right.

Path parameters

allowedAccountId
required
integer

Account id to give send on behalf to

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200exchangeAccountSendOnBehalfTosuccessful operation
allowedAccountId
read-only
integer

Account id to give send on behalf to

creationDate
read-only
stringdate-time

Creation date

taskPendingId
read-only
integer

Pending task id

Example uses allowedAccountId = 0, exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendOnBehalfTo/{allowedAccountId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "allowedAccountId": 0, "creationDate": "2024-01-01T12:00:00Z", "taskPendingId": 0}

Add a send on behalf permissionProduction

POST
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendOnBehalfTo

Add a send on behalf permission. Allows the account given by allowAccountId to send emails on behalf of the email account, and returns the task.

Path parameters

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Request body (required)

allowAccountId
required
integer

Account id to allow to send On Behalf To mails from this mailbox

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendOnBehalfTo \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Remove a send on behalf permissionProduction

DELETE
/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendOnBehalfTo/{allowedAccountId}

Remove a send on behalf permission. Withdraws the right of the allowed account to send emails on behalf of this email account, and returns the task.

Path parameters

allowedAccountId
required
integer

Account id to give send on behalf to

exchangeService
required
string

The internal name of your exchange service

organizationName
required
string

The internal name of your exchange organization

primaryEmailAddress
required
string

Default email for this mailbox

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateSharepointaddAccountaddAccountArchiveaddAccountImpersonationaddActiveSyncMailNotificationaddAliasaddDistributionGroupaddDistributionGroupManageraddDistributionGroupMemberaddDistributionGroupSendAsaddDistributionGroupSendOnBehalfToaddDomainaddDomainDisclaimeraddExchangeCustomIsolationaddExchangeDomainDKIMaddExchangeRemoteMailboxaddExchangeServiceAuthorizedIpaddExportPstRequestaddExternalContactaddFullAccessaddOutlookLicenseaddPublicFolderaddPublicFolderPermissionaddResourceAccountaddResourceDelegateaddSendAsaddSendConnectoraddSendOnBehalfToaddSharedAccountaddSharedAccountFullAccessaddSharedAccountSendAsaddSharedAccountSendOnBehalfTochangeHostnamechangePasswordclearDataOnDevicecloneTemplateExchangePrivateconfigureExchangeCustomerconfigureExchangeOwaMfacopyMailboxcreateExternalAntiSpamReceiveConnectordeleteAccountdeleteAccountArchivedeleteAccountImpersonationdeleteActiveSyncMailNotificationdeleteAliasdeleteDistributionGroupdeleteDistributionGroupManagerdeleteDistributionGroupMemberdeleteDistributionGroupSendAsdeleteDistributionGroupSendOnBehalfTodeleteDomaindeleteDomainDisclaimerdeleteExchangeCustomIsolationdeleteExchangeDomainDKIMdeleteExchangeRemoteMailboxdeleteExchangeServicedeleteExchangeServiceAuthorizedIpdeleteExportPstRequestdeleteExternalAntiSpamReceiveConnectordeleteExternalContactdeleteFullAccessdeleteOutlookLicensedeletePublicFolderdeletePublicFolderPermissiondeleteResourceAccountdeleteResourceDelegatedeleteSendAsdeleteSendConnectordeleteSendOnBehalfTodeleteSharedAccountdeleteSharedAccountFullAccessdeleteSharedAccountSendAsdeleteSharedAccountSendOnBehalfTodestroyPrivateVmdiagnoseAccountdisableExchangeDKIMenableExchangeDKIMexpandDrivegenerateOutlookUrlgeneratePstUrlinstallExchangeinstallSSLmaintenancemigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationMailingListmigrationResourceAccountmigrationServicereOpenHostedAccountreOpenOutlookLicensereOpenPrivateAccountreOpenPrivateVmsetAccountsetAccountArchivesetAliassetDistributionGroupsetDnssetDomainsetDomainDisclaimersetExchangeAccountProtocolsetExchangeRemoteMailboxsetExchangeServiceDevicesetExternalAntiSpamReceiveConnectorsetExternalContactsetPublicFoldersetPublicFolderPermissionsetResourceAccountsetSendConnectorsetServicesetSharedAccountsuspendAccountsuspendExchangeServicesuspendHostedAccountsuspendOutlookLicensesuspendPrivateAccountsuspendPrivateVmunsuspendAccountunsuspendExchangeServiceunsuspendHostedAccountupdateExchangeServiceDeviceupgrade2016
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses allowedAccountId = 0, exchangeService = string, organizationName = string, primaryEmailAddress = string

$ curl https://api.eu.ovhcloud.com/1.0/email/exchange/{organizationName}/service/{exchangeService}/account/{primaryEmailAddress}/sendOnBehalfTo/{allowedAccountId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateSharepoint", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

List Active Directory accountsProduction

GET
/1.0/msServices/{serviceName}/account

List Active Directory accounts. Returns the user principal names of the accounts of the Active Directory service. Filter them by company, id or userPrincipalName.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

Query parameters

company
string

Filter the value of company property (like)

id
integer

Filter the value of id property (like)

userPrincipalName
string

Filter the value of userPrincipalName property (like)

Response

200string[]successful operation

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ "string"]

Get an Active Directory accountProduction

GET
/1.0/msServices/{serviceName}/account/{userPrincipalName}

Get an Active Directory account. Returns the identity, contact details, job information, state and last logon and logoff dates of the account.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

userPrincipalName
required
string

User Principal Name

Response

200Accountsuccessful operation
SAMAccountName
read-only
string

SAM account name

city
string

city

company
string

Company name

countryCode
CountryCodeEnum

Country code

ValuesACADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDGDJDKDMDODZEAECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHNHRHTHUICIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTATCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSXKYEYTZAZMZW
creationDate
read-only
stringdate-time

Creation date

description
string

Description

displayName
string

Account display name

entraIdSynced
boolean

Is synced to Entra ID

fax
phoneNumber

Fax number

firstName
string

Account first name

guid
read-only
string

GUID for user in active directory

id
read-only
integer

Account id

initials
string

Account initials

jobDepartment
string

Job Department

jobTitle
string

Job title

lastLogoffDate
read-only
stringdate-time

Last logoff

lastLogonDate
read-only
stringdate-time

Last logon

lastName
string

Account last name

lastUpdateDate
read-only
stringdate-time

Last update

mobile
phoneNumber

Mobile phone

office
string

Job office

passwordLastUpdate
read-only
stringdate-time

Time of account's password last update

phone
phoneNumber

Phone number

postalCode
string

Postal code

region
string

region

state
read-only
ObjectStateEnum

Account state

Valuescreatingdeletingdisabledmodifyingokreopeningsuspendedsuspending
streetAddress
string

Street address

taskPendingId
read-only
integer

Pending task for this account

userPrincipalName
string

User Principal Name

Example uses serviceName = string, userPrincipalName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account/{userPrincipalName} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "SAMAccountName": "string", "city": "string", "company": "string", "countryCode": "AC", "creationDate": "2024-01-01T12:00:00Z", "description": "string", "displayName": "string", "entraIdSynced": true, "fax": "string", "firstName": "string", "guid": "string", "id": 0, "initials": "string", "jobDepartment": "string", "jobTitle": "string", "lastLogoffDate": "2024-01-01T12:00:00Z", "lastLogonDate": "2024-01-01T12:00:00Z", "lastName": "string", "lastUpdateDate": "2024-01-01T12:00:00Z", "mobile": "string", "office": "string", "passwordLastUpdate": "2024-01-01T12:00:00Z", "phone": "string", "postalCode": "string", "region": "string", "state": "creating", "streetAddress": "string", "taskPendingId": 0, "userPrincipalName": "string"}

Update an Active Directory accountProduction

PUT
/1.0/msServices/{serviceName}/account/{userPrincipalName}

Update an Active Directory account. Updates the user principal name, names, contact details and job information of the account.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

userPrincipalName
required
string

User Principal Name

Request body (required)

SAMAccountName
read-only
string

SAM account name

city
string

city

company
string

Company name

countryCode
CountryCodeEnum

Country code

ValuesACADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDGDJDKDMDODZEAECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHNHRHTHUICIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTATCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSXKYEYTZAZMZW
creationDate
read-only
stringdate-time

Creation date

description
string

Description

displayName
string

Account display name

entraIdSynced
boolean

Is synced to Entra ID

fax
phoneNumber

Fax number

firstName
string

Account first name

guid
read-only
string

GUID for user in active directory

id
read-only
integer

Account id

initials
string

Account initials

jobDepartment
string

Job Department

jobTitle
string

Job title

lastLogoffDate
read-only
stringdate-time

Last logoff

lastLogonDate
read-only
stringdate-time

Last logon

lastName
string

Account last name

lastUpdateDate
read-only
stringdate-time

Last update

mobile
phoneNumber

Mobile phone

office
string

Job office

passwordLastUpdate
read-only
stringdate-time

Time of account's password last update

phone
phoneNumber

Phone number

postalCode
string

Postal code

region
string

region

state
read-only
ObjectStateEnum

Account state

Valuescreatingdeletingdisabledmodifyingokreopeningsuspendedsuspending
streetAddress
string

Street address

taskPendingId
read-only
integer

Pending task for this account

userPrincipalName
string

User Principal Name

Response

200—successful operation

Example uses serviceName = string, userPrincipalName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account/{userPrincipalName} \
  -H "authorization: Bearer $OVH_TOKEN"

Change the Active Directory passwordProduction

POST
/1.0/msServices/{serviceName}/account/{userPrincipalName}/changePassword

Change the Active Directory password. Changes the password of the Active Directory account and returns the task.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

userPrincipalName
required
string

User Principal Name

Request body (required)

password
required
stringpassword

new password

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateADSyncactivateSharepointaddADAccountaddADOUaddADSyncAccountaddADUPNSuffixalterMfaOnAllUserschangeADPasswordchangeADSyncPassworddeactivateADSyncdelADOUdeleteADAccountdeleteADSyncAccountdeleteADUPNSuffixdisableADAccountMfadisableADAccountMfaTemporaryenableADAccountMfaenableADSyncAccountgenerateADSyncClientUrlresetADAccountMfasetADAccountsetPasswordPolicy
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses serviceName = string, userPrincipalName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account/{userPrincipalName}/changePassword \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateADSync", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Get an account mailboxProduction

GET
/1.0/msServices/{serviceName}/account/{userPrincipalName}/exchange

Get an account mailbox. Returns the Exchange mailbox of the Active Directory account: primary address, license, quota, usage, Outlook license, renewal and expiration settings, and spam and antivirus configuration.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

userPrincipalName
required
string

User Principal Name

Response

200ExchangeInformationsuccessful operation
accountLicense
ExchangeLicenceEnum

Exchange account license

Valuesbasicenterprisestandard
configured
read-only
boolean

Indicates if the account is configured

creationDate
read-only
stringdate-time

Creation date

currentUsage
read-only
integer

Mailbox usage in KB

deleteAtExpiration
boolean

Delete mailbox at expiration date

deleteOutlookAtExpiration
boolean

Delete Outlook license at expiration date

exchangeGuid
read-only
string

Property needed for mailbox manual configuration (GUID)

expirationDate
read-only
stringdate-time

Expiration date

expirationOutlookDate
read-only
stringdate-time

Expiration date of Outlook license

hiddenFromGAL
boolean

Visibility in Global Address List

id
read-only
integer

Account id

litigation
boolean

Litigation hold feature enabled on this mailbox

litigationPeriod
integer

Litigation hold period in days (0 means unlimited). This setting covers all items in the mailbox.

mailingFilter
MailingFilterEnum[]

Enable or disable anti-virus and anti-spam

Valuesvaderetro
numberOfAliases
read-only
integer

Count the number of related aliases attached to this account

outlookLicense
boolean

Outlook licence attached

owaLimited
read-only
boolean

OWA policy restriction is applied

primaryEmailAddress
read-only
string

Primary address of the mailbox

quota
integer

Maximum mailbox usage in GB (overall size)

renewOutlookPeriod
RenewPeriodEnum

Frequency of Outlook license renewals

Valuesmonthlyyearly
renewPeriod
RenewPeriodEnum

Frequency of mailbox license renewals

Valuesmonthlyyearly
spamAndVirusConfiguration
SpamAndVirusConfiguration

Spam and Antivirus configuration

spamDetected
read-only
boolean

Spam activity detected on this mailbox

spamTicketNumber
read-only
integer

Ticket number of spam detection

state
read-only
ObjectStateEnum

Mailbox state

Valuescreatingdeletingdisabledmodifyingokreopeningsuspendedsuspending
taskPendingId
read-only
integer

Pending task id for this account

Example uses serviceName = string, userPrincipalName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account/{userPrincipalName}/exchange \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "accountLicense": "basic", "configured": true, "creationDate": "2024-01-01T12:00:00Z", "currentUsage": 0, "deleteAtExpiration": true, "deleteOutlookAtExpiration": true, "exchangeGuid": "string", "expirationDate": "2024-01-01T12:00:00Z", "expirationOutlookDate": "2024-01-01T12:00:00Z", "hiddenFromGAL": true, "id": 0, "litigation": true, "litigationPeriod": 0, "mailingFilter": [ "vaderetro" ], "numberOfAliases": 0, "outlookLicense": true, "owaLimited": true, "primaryEmailAddress": "string", "quota": 0, "renewOutlookPeriod": "monthly", "renewPeriod": "monthly", "spamAndVirusConfiguration": { "checkDKIM": true, "checkSPF": true, "deleteSpam": true, "deleteVirus": true, "putInJunk": true, "tagSpam": true, "tagVirus": true }, "spamDetected": true, "spamTicketNumber": 0, "state": "creating", "taskPendingId": 0}

Update an account mailboxProduction

PUT
/1.0/msServices/{serviceName}/account/{userPrincipalName}/exchange

Update an account mailbox. Updates the license, quota, Outlook license, renewal and deletion at expiration settings, litigation hold, Global Address List visibility and spam and antivirus configuration of the mailbox.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

userPrincipalName
required
string

User Principal Name

Request body (required)

accountLicense
ExchangeLicenceEnum

Exchange account license

Valuesbasicenterprisestandard
configured
read-only
boolean

Indicates if the account is configured

creationDate
read-only
stringdate-time

Creation date

currentUsage
read-only
integer

Mailbox usage in KB

deleteAtExpiration
boolean

Delete mailbox at expiration date

deleteOutlookAtExpiration
boolean

Delete Outlook license at expiration date

exchangeGuid
read-only
string

Property needed for mailbox manual configuration (GUID)

expirationDate
read-only
stringdate-time

Expiration date

expirationOutlookDate
read-only
stringdate-time

Expiration date of Outlook license

hiddenFromGAL
boolean

Visibility in Global Address List

id
read-only
integer

Account id

litigation
boolean

Litigation hold feature enabled on this mailbox

litigationPeriod
integer

Litigation hold period in days (0 means unlimited). This setting covers all items in the mailbox.

mailingFilter
MailingFilterEnum[]

Enable or disable anti-virus and anti-spam

Valuesvaderetro
numberOfAliases
read-only
integer

Count the number of related aliases attached to this account

outlookLicense
boolean

Outlook licence attached

owaLimited
read-only
boolean

OWA policy restriction is applied

primaryEmailAddress
read-only
string

Primary address of the mailbox

quota
integer

Maximum mailbox usage in GB (overall size)

renewOutlookPeriod
RenewPeriodEnum

Frequency of Outlook license renewals

Valuesmonthlyyearly
renewPeriod
RenewPeriodEnum

Frequency of mailbox license renewals

Valuesmonthlyyearly
spamAndVirusConfiguration
SpamAndVirusConfiguration

Spam and Antivirus configuration

spamDetected
read-only
boolean

Spam activity detected on this mailbox

spamTicketNumber
read-only
integer

Ticket number of spam detection

state
read-only
ObjectStateEnum

Mailbox state

Valuescreatingdeletingdisabledmodifyingokreopeningsuspendedsuspending
taskPendingId
read-only
integer

Pending task id for this account

Response

200—successful operation

Example uses serviceName = string, userPrincipalName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account/{userPrincipalName}/exchange \
  -H "authorization: Bearer $OVH_TOKEN"

Get the account MFAProduction

GET
/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa

Get the account MFA. Returns whether MFA is activated on the Active Directory account, and its state.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

userPrincipalName
required
string

User Principal Name

Response

200MfaInformationsuccessful operation
activated
read-only
boolean

Indicates if Multi Factor Authentication is activated on this account

state
read-only
ObjectStateEnum

Current status of Multi Factor Authentication feature

Valuescreatingdeletingdisabledmodifyingokreopeningsuspendedsuspending
taskPendingId
read-only
integer

Pending task for Multi Factor Authentication

Example uses serviceName = string, userPrincipalName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "activated": true, "state": "creating", "taskPendingId": 0}

Create the account MFAProduction

POST
/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa

Create the account MFA. Creates MFA for the Active Directory account and returns the task. MFA is enabled by default when created.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

userPrincipalName
required
string

User Principal Name

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateADSyncactivateSharepointaddADAccountaddADOUaddADSyncAccountaddADUPNSuffixalterMfaOnAllUserschangeADPasswordchangeADSyncPassworddeactivateADSyncdelADOUdeleteADAccountdeleteADSyncAccountdeleteADUPNSuffixdisableADAccountMfadisableADAccountMfaTemporaryenableADAccountMfaenableADSyncAccountgenerateADSyncClientUrlresetADAccountMfasetADAccountsetPasswordPolicy
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses serviceName = string, userPrincipalName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateADSync", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Delete the account MFAProduction

DELETE
/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa

Delete the account MFA. Removes the MFA of the Active Directory account and returns the task. The user signs in with a password only.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

userPrincipalName
required
string

User Principal Name

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateADSyncactivateSharepointaddADAccountaddADOUaddADSyncAccountaddADUPNSuffixalterMfaOnAllUserschangeADPasswordchangeADSyncPassworddeactivateADSyncdelADOUdeleteADAccountdeleteADSyncAccountdeleteADUPNSuffixdisableADAccountMfadisableADAccountMfaTemporaryenableADAccountMfaenableADSyncAccountgenerateADSyncClientUrlresetADAccountMfasetADAccountsetPasswordPolicy
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses serviceName = string, userPrincipalName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateADSync", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Disable the account MFAProduction

POST
/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa/disable

Disable the account MFA. Disables MFA on the Active Directory account for period hours, and returns the task.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

userPrincipalName
required
string

User Principal Name

Request body (required)

period
required
integer

Multi Factor Authentication disable period in hours

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateADSyncactivateSharepointaddADAccountaddADOUaddADSyncAccountaddADUPNSuffixalterMfaOnAllUserschangeADPasswordchangeADSyncPassworddeactivateADSyncdelADOUdeleteADAccountdeleteADSyncAccountdeleteADUPNSuffixdisableADAccountMfadisableADAccountMfaTemporaryenableADAccountMfaenableADSyncAccountgenerateADSyncClientUrlresetADAccountMfasetADAccountsetPasswordPolicy
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses serviceName = string, userPrincipalName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa/disable \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateADSync", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Enable the account MFAProduction

POST
/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa/enable

Enable the account MFA. Enables MFA on the Active Directory account and returns the task. MFA is enabled by default when created.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

userPrincipalName
required
string

User Principal Name

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateADSyncactivateSharepointaddADAccountaddADOUaddADSyncAccountaddADUPNSuffixalterMfaOnAllUserschangeADPasswordchangeADSyncPassworddeactivateADSyncdelADOUdeleteADAccountdeleteADSyncAccountdeleteADUPNSuffixdisableADAccountMfadisableADAccountMfaTemporaryenableADAccountMfaenableADSyncAccountgenerateADSyncClientUrlresetADAccountMfasetADAccountsetPasswordPolicy
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses serviceName = string, userPrincipalName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa/enable \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateADSync", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Reset the account MFAProduction

POST
/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa/reset

Reset the account MFA. Resets the MFA of the Active Directory account, so that the user registers again at the next sign-in. Returns the task.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

userPrincipalName
required
string

User Principal Name

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateADSyncactivateSharepointaddADAccountaddADOUaddADSyncAccountaddADUPNSuffixalterMfaOnAllUserschangeADPasswordchangeADSyncPassworddeactivateADSyncdelADOUdeleteADAccountdeleteADSyncAccountdeleteADUPNSuffixdisableADAccountMfadisableADAccountMfaTemporaryenableADAccountMfaenableADSyncAccountgenerateADSyncClientUrlresetADAccountMfasetADAccountsetPasswordPolicy
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses serviceName = string, userPrincipalName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/account/{userPrincipalName}/mfa/reset \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateADSync", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Create MFA on all accountsProduction

POST
/1.0/msServices/{serviceName}/createMfaOnAllUsers

Create MFA on all accounts. Creates MFA for all the accounts of the Active Directory service and returns the task.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateADSyncactivateSharepointaddADAccountaddADOUaddADSyncAccountaddADUPNSuffixalterMfaOnAllUserschangeADPasswordchangeADSyncPassworddeactivateADSyncdelADOUdeleteADAccountdeleteADSyncAccountdeleteADUPNSuffixdisableADAccountMfadisableADAccountMfaTemporaryenableADAccountMfaenableADSyncAccountgenerateADSyncClientUrlresetADAccountMfasetADAccountsetPasswordPolicy
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/createMfaOnAllUsers \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateADSync", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Remove MFA from all accountsProduction

POST
/1.0/msServices/{serviceName}/removeMfaOnAllUsers

Remove MFA from all accounts. Removes MFA from all the accounts of the Active Directory service and returns the task.

Path parameters

serviceName
required
string

The internal name of your Active Directory organization

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesactivateADSyncactivateSharepointaddADAccountaddADOUaddADSyncAccountaddADUPNSuffixalterMfaOnAllUserschangeADPasswordchangeADSyncPassworddeactivateADSyncdelADOUdeleteADAccountdeleteADSyncAccountdeleteADUPNSuffixdisableADAccountMfadisableADAccountMfaTemporaryenableADAccountMfaenableADSyncAccountgenerateADSyncClientUrlresetADAccountMfasetADAccountsetPasswordPolicy
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/msServices/{serviceName}/removeMfaOnAllUsers \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "activateADSync", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}