This is an archive version of the document. To get the most up-to-date information, see the current version.Organizations with Basic Authentication
You can add Microsoft 365 organizations using basic authentication.
Request
POST https://<hostname>:4443/v6/Organizations |
Request Headers
The request header must contain an authorization token of the current session.
Request Parameters
None.
Request Body
The request body must contain the following properties:
Property | Type | Description |
|---|---|---|
type | string | Specifies the type of the organization you add. The following types are available:
|
region | string | Specifies Microsoft Azure region. The following values are available:
|
isExchangeOnline | boolean | Defines whether to add an Exchange Online organization. |
isSharePointOnline | boolean | Defines whether to add a SharePoint Online organization. |
isTeamsOnline | boolean | Defines whether the added organization uses Microsoft Teams. If set to true, indicates that you will be able to back up Microsoft Teams data for this organization. |
isTeamsChatsOnline | boolean | Defines whether the added organization uses team chats. Backup of team chats using Protected APIs in Microsoft Teams is not supported for Microsoft 365 organizations with basic authentication. You must set this property to false. Note: This property is available starting from Veeam Backup for Microsoft 365 version 6a (build 6.1.0.222). |
exchangeOnlineSettings | Specifies the ExchangeOnlineSettings object. | |
sharePointOnlineSettings | Specifies the SharePointOnlineSettings object. |
Property | Type | Description |
|---|---|---|
account | string | Specifies the user account with enabled multi-factor authentication (MFA). |
password | string | Specifies the password for the specified user. |
grantAdminAccess | boolean | Defines whether to grant administrative permissions. |
useMfa | boolean | Defines whether to use multi-factor authentication. |
useCustomVeeamAADApplication | boolean | Defines whether to use a custom Azure AD application that is automatically configured by Veeam Backup for Microsoft 365. |
sharePointOnlineSettings Objects
Property | Type | Description |
|---|---|---|
account | string | Specifies the user account with enabled multi-factor authentication (MFA). |
password | string | Specifies the password for the specified user. |
grantAdminAccess | boolean | Defines whether to grant administrative permissions. |
useMfa | boolean | Defines whether to use multi-factor authentication. |
useCustomVeeamAADApplication | booleanesn | Defines whether to use a custom Azure AD application that is automatically configured by Veeam Backup for Microsoft 365. |
Request Example
Request: POST https://abc.tech.local:4443/v6/Organizations
Request Header: Authorization: Bearer <Access-Token>
Request Body: { "type": "Office365", "region": "Worldwide", "isExchangeOnline": true, "isSharePointOnline": true, "isTeamsChatsOnline": false, "sharePointOnlineSettings": { "account": "administrator@abc.onmicrosoft.com", "password": "XXXXXXXX", "grantAdminAccess": true, "useMfa": false, "useCustomVeeamAADApplication": false }, "exchangeOnlineSettings": { "account": "administrator@abc.onmicrosoft.com", "password": "XXXXXXXX", "grantAdminAccess": true, "useMfa": false, "useCustomVeeamAADApplication": false } } |
Response
The server returns the following response to the client.
Response Codes
A successfully completed operation returns a response code 200 OK.
Response Headers
The response to this request contains the following headers. The response may also include additional standard HTTPS headers.
Header | Description |
|---|---|
Content-length | The length of the response body. |
Content-type | The media type and syntax of the response body message: application/json; charset=utf-8 |
Response Body
The response body contains the following properties:
Property | Type | Description |
|---|---|---|
exchangeOnlineSettings | object | Specifies the configuration of the Exchange Online organization. |
sharePointOnlineSettings | object | Specifies the configuration of the SharePoint Online organization. |
type | string | Specifies the type of the organization. The following types are available:
|
region | string | Specifies the Microsoft Azure region. |
isExchangeOnline | boolean | Defines whether the Exchange Online organization is added. |
isSharePointOnline | boolean | Defines whether the SharePoint Online organization is added. |
isTeamsOnline | boolean | Defines whether the added organization uses Microsoft Teams. If set to true, indicates that you will be able to back up Microsoft Teams data for this organization. |
isTeamsChatsOnline | boolean | Defines whether the added organization uses team chats. Backup of team chats using Protected APIs in Microsoft Teams is not supported for Microsoft 365 organizations with basic authentication. This property must be set to false. Note: This property is available starting from Veeam Backup for Microsoft 365 version 6a (build 6.1.0.222). |
id | string | Specifies the identification number of the Microsoft 365 organization. |
name | string | Specifies the name of the organization in Veeam Backup for Microsoft 365. |
officeName | string | Specifies the Microsoft 365 Online name. |
isBackedup | boolean | Defines whether the organizations has backups. |
firstBackuptime | string | Specifies when the first backup was created for the organization. |
lastBackuptime | string | Specifies when the last backup was created for the organization. |
_links | Dictionary of string [key] and Object [value] | Links to related resources (navigation property). |
Response Example
Response: 200 OK
Response Body: { "isTeamsOnline": true, "isTeamsChatsOnline": false, "exchangeOnlineSettings": { "account": "administrator@abc.onmicrosoft.com", "password": "XXXXXXXX", "grantAdminAccess": true, "useMfa": false, "useCustomVeeamAADApplication": false }, "sharePointOnlineSettings": { "account": "administrator@abc.onmicrosoft.com", "password": "XXXXXXXX", "grantAdminAccess": true, "useMfa": false, "useCustomVeeamAADApplication": false }, "type": "Office365", "region": "Worldwide", "isExchangeOnline": true, "isSharePointOnline": true, "id": "7f9a9b85-50e7-4f61-8f76-6a9517b8677d", "name": "abc.onmicrosoft.com", "officeName": "abc.onmicrosoft.com", "isBackedup": false, "_links": { "self": {"href": "/v6/organizations/7f9a9b85-50e7-4f61-8f76-6a9517b8677d"}, "jobs": {"href": "/v6/organizations/7f9a9b85-50e7-4f61-8f76-6a9517b8677d/jobs"}, "groups": {"href": "/v6/organizations/7f9a9b85-50e7-4f61-8f76-6a9517b8677d/groups"}, "users": {"href": "/v6/organizations/7f9a9b85-50e7-4f61-8f76-6a9517b8677d/users"}, "sites": {"href": "/v6/organizations/7f9a9b85-50e7-4f61-8f76-6a9517b8677d/sites"}, "usedRepositories": {"href": "/v6/organizations/7f9a9b85-50e7-4f61-8f76-6a9517b8677d/usedRepositories"} }, "_actions": {} } |