Veeam Backup for Microsoft 365 8
REST API Reference
Related documents

Audit Email Notification Settings

The /AuditEmailSettings resource collection allows you to configure audit notification settings. Veeam Backup for Microsoft 365 sends audit email notifications for each operation performed with the backed-up data of a specific user or group.

For more information, see the Veeam Backup for Microsoft 365 REST API Reference, section Backed-Up Data Audit.

Get Audit Notification Settings

Returns a resource representation of audit notification settings.

SecurityBearer
Responses
200

OK

default

Operation failure response.

get/v8/AuditEmailSettings
Request samples 
Response samples 
application/json
{
  • "_links": {
    },
  • "_actions": {
    },
  • "enableNotification": true,
  • "smtpServer": "string",
  • "port": 0,
  • "useAuthentication": true,
  • "username": "string",
  • "useSSL": true,
  • "from": "string",
  • "to": "string",
  • "subject": "string",
  • "authenticationType": "CustomSmtp",
  • "clientId": "string",
  • "tenantId": "string",
  • "userId": "string",
  • "mailApiUrl": "string",
  • "isAuthenticated": true
}
Edit Audit Notification Settings
Modifies audit notification settings.


x-codegen-request-body-name:  emailSettingsRequest
SecurityBearer 
Request 
Request Body schema: application/json
required
userPassword
string <password>  (SecureString) 
Specifies a password.


 
enableNotification
boolean or null
Defines whether Veeam Backup for Microsoft 365 will send audit notifications by email.


 
smtpServer
string
Specifies the full DNS name or IP address of the SMTP server for sending audit email notifications.


 
port
integer or null <int32> 
Specifies the port used for connection to the SMTP server.


 
useAuthentication
boolean or null
Defines whether the SMTP server requires authentication.


 
username
string
Specifies the user name of the account used for authentication to the SMTP server.


 
useSSL
boolean or null
Defines whether Veeam Backup for Microsoft 365 will use a secure connection to transmit audit email notifications.


 
from
string
Specifies email address of the notification sender.


 
to
string
Specifies email address of the notification recipient. For listing multiple recipients, use semicolon as a separator.


 
subject
string
Specifies the subject for audit email notifications. The subject of an email notification displays information according to the following variables: 
     
  • %OrganizationName% - organization whose data was processed by a backup or backup copy job.
    •  
  • %DisplayName% - display name of the backed-up item for which a user performed an operation.
    •  
  • %Action% - name of the operation performed with the backed-up data.
    •  
  • %InitiatedByUserName% - user name of the account used to perform an operation with the backed-up data.
    •  
  • %StartTime% - date and time when a user performed an operation with the backed-up data.
    •  


 
authenticationType
string (RESTAuthenticationType) 
Specifies authentication method that Veeam Backup for Microsoft 365 and Veeam Explorers use to send emails.


 Enum: "CustomSmtp" "GoogleGmail" "Microsoft365"  
userId
string
Specifies an authenticated user account ID. Veeam Backup for Microsoft 365 will send audit email notifications on behalf of this user.


 
mailApiUrl
string or null
Specifies the Microsoft Graph endpoint for sending emails.


 
requestId
string or null
Specifies an authentication request ID.


 
Responses 
204
No Content


default
Operation failure response.


put/v8/AuditEmailSettings
Request samples 
application/json
{
  • "userPassword": "pa$$word",
  • "enableNotification": true,
  • "smtpServer": "string",
  • "port": 0,
  • "useAuthentication": true,
  • "username": "string",
  • "useSSL": true,
  • "from": "string",
  • "to": "string",
  • "subject": "string",
  • "authenticationType": "CustomSmtp",
  • "userId": "string",
  • "mailApiUrl": "string",
  • "requestId": "string"
}
Response samples 
application/json
{
  • "message": "string",
  • "errorCode": "ProxyOffline",
  • "stackTrace": "string"
}
Prepare to Authentication Request
Prepares to create authentication request that allows you to acquire an access token. Veeam Backup for Microsoft 365 will send audit email notifications on behalf of either a Microsoft 365 account or a Google account.


SecurityBearer 
Request 
Request Body schema: application/json
required
authenticationServiceKind
string (RESTOAuth2ServiceKind) 
Specifies account that you want to use to acquire an access token from Google or Microsoft Identity platform.


 Enum: "GoogleGmail" "Microsoft365"  
clientId
string or null
Specifies a client ID obtained while registering an application in the Google Cloud console or Microsoft Identity platform.


 
clientSecret
string <password>  (SecureString) 
Specifies a password.


 
tenantId
string or null
Specifies a tenant ID in Microsoft Entra ID.


 
redirectUrl
string
Specifies URL to which you will be redirected after signing in to Google or Microsoft Identity platform to get the code and state properties required to complete authentication. For more information, see Complete Authentication.


 
Responses 
200
OK


default
Operation failure response.


post/v8/AuditEmailSettings/PrepareOAuthSignIn
Request samples 
application/json
{
  • "authenticationServiceKind": "GoogleGmail",
  • "clientId": "string",
  • "clientSecret": "pa$$word",
  • "tenantId": "string",
  • "redirectUrl": "string"
}
Response samples 
application/json
{
  • "requestId": "string",
  • "signInUrl": "string"
}
Complete Authentication
Completes authentication to Google or Microsoft Identity platform that allows Veeam Backup for Microsoft 365 to send audit email notifications on behalf of either a Microsoft 365 account or a Google account.


SecurityBearer 
Request 
Request Body schema: application/json
required
code
string
Specifies value that you get from the Google Authorization Server or Microsoft Identity platform in the redirect URL. Veeam Backup for Microsoft 365 and Veeam Explorers will use this value to obtain an access token.


 
state
string
Specifies value that you get from the Google Authorization Server or Microsoft Identity platform in the redirect URL. Veeam Backup for Microsoft 365 and Veeam Explorers will use this value to check that the code property value matches the authentication request.


 
Responses 
200
OK


default
Operation failure response.


post/v8/AuditEmailSettings/CompleteOAuthSignIn
Request samples 
application/json
{
  • "code": "string",
  • "state": "string"
}
Response samples 
application/json
{
  • "requestId": "string",
  • "userId": "string"
}
Send Test Message
Sends a test message to the specified recipient.


SecurityBearer 
Responses 
204
No Content


default
Operation failure response.


post/v8/AuditEmailSettings/SendTestEmail
Request samples 
Response samples 
application/json
{
  • "message": "string",
  • "errorCode": "ProxyOffline",
  • "stackTrace": "string"
}

    
    

                                

                                    
Document updated 12/18/2025
Page content applies to build 8.3.0.2201