CIAM Tenants - Create

Service:: Azure AD B2C

API Version:: 2023-05-17-preview

Initiates an async request to create both the Azure AD for customers tenant and the corresponding Azure resource linked to a subscription. Note: Please check name availability before creating a new tenant

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureActiveDirectory/ciamDirectories/{resourceName}?api-version=2023-05-17-preview

URI Parameters

Name	In	Required	Type	Description
resourceGroupName	path	True	string	The name of the resource group.
resourceName	path	True	string maxLength: 26 pattern: ^[a-zA-Z0-9]{1,26}	The initial sub domain of the tenant.
subscriptionId	path	True	string	Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.
api-version	query	True	string	Version of the API to be used with the client request.

Request Body

Name	Required	Type	Description
location	True	string	The location in which the resource is hosted and data resides. Can be one of 'United States', 'Europe', 'Asia Pacific', or 'Australia'. Refer to this documentation for more information.
properties.createTenantProperties.countryCode	True	string	Country code of Azure tenant (e.g. 'US'). Refer to https://aka.ms/ciam-data-location to see valid country codes and corresponding data residency locations. If you do not see a country code in an valid data residency location, choose one from the list.
properties.createTenantProperties.displayName	True	string	The display name of the Azure AD for customers tenant.
sku	True	CIAMResourceSKU	SKU properties of the Azure AD for customers tenant. Learn more about Azure AD for customers billing at https://aka.ms/ciambilling.
properties.tenantId		string	An identifier of the Azure AD for customers tenant.
tags		object	Resource Tags

Responses

Name	Type	Description
200 OK	CIAMTenantResource	OK - Successfully updated an existing Azure AD for customers tenant resource.
201 Created	CIAMTenantResource	Azure AD for customers tenant create request was successfully started and will complete asynchronously. Headers Azure-AsyncOperation: string Retry-After: string
Other Status Codes	ErrorResponse	Error response describing why the operation failed.

Name

Type

Description

200 OK

CIAMTenantResource

OK - Successfully updated an existing Azure AD for customers tenant resource.

201 Created

CIAMTenantResource

Azure AD for customers tenant create request was successfully started and will complete asynchronously.

Headers

Azure-AsyncOperation: string
Retry-After: string

Other Status Codes

ErrorResponse

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

Create_CIAM_tenant

Sample request

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/contosoResourceGroup/providers/Microsoft.AzureActiveDirectory/ciamDirectories/contoso?api-version=2023-05-17-preview

{
  "location": "United States",
  "sku": {
    "name": "Standard",
    "tier": "A0"
  },
  "properties": {
    "createTenantProperties": {
      "displayName": "Contoso",
      "countryCode": "US"
    }
  }
}

Sample response

Status code:: 200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/contosoResourceGroup/providers/Microsoft.AzureActiveDirectory/ciamDirectories/contoso",
  "name": "contoso",
  "type": "Microsoft.AzureActiveDirectory/ciamDirectories",
  "location": "United States",
  "sku": {
    "name": "Standard",
    "tier": "A0"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "createTenantProperties": {
      "displayName": "Contoso",
      "countryCode": "US"
    },
    "billingConfig": {
      "billingType": "MAU",
      "effectiveStartDateUtc": "1/1/0001 12:00:00 AM"
    },
    "domainName": "contoso.onmicrosoft.com",
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "tags": null,
  "systemData": {
    "createdBy": "contosoAdmin@onmicrosoft.com",
    "createdByType": "User",
    "createdAt": "2020-02-03T01:01:01.1075056Z",
    "lastModifiedBy": "contosoAdmin@onmicrosoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-02-04T01:01:01.1075056Z"
  }
}

Status code:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/e70a6dd9-57ab-481e-9668-a6899e3f13f6/providers/Microsoft.AzureActiveDirectory/operationStatuses/f57cbcaf-5d23-495e-8414-43fe19cb9e82?api-version=2023-05-17-preview
Retry-After: 60

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/contosoResourceGroup/providers/Microsoft.AzureActiveDirectory/ciamDirectories/contoso.onmicrosoft.com",
  "name": "contoso.onmicrosoft.com",
  "type": "Microsoft.AzureActiveDirectory/ciamDirectories",
  "location": "United States",
  "sku": {
    "name": "Standard",
    "tier": "A0"
  },
  "properties": {
    "provisioningState": "Provisioning",
    "createTenantProperties": {
      "displayName": "Contoso",
      "countryCode": "US"
    },
    "billingConfig": {
      "billingType": "MAU",
      "effectiveStartDateUtc": "1/1/0001 12:00:00 AM"
    },
    "tenantId": "00000000-0000-0000-0000-000000000000"
  },
  "tags": null,
  "systemData": {
    "createdBy": "contosoAdmin@onmicrosoft.com",
    "createdByType": "User",
    "createdAt": "2020-02-03T01:01:01.1075056Z",
    "lastModifiedBy": "contosoAdmin@onmicrosoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-02-04T01:01:01.1075056Z"
  }
}

Definitions

Name	Description
ciamBillingType	The type of billing. Will be MAU for all new customers. Cannot be changed if value is 'MAU'. Learn more about Azure AD for customers billing at aka.ms/b2cBilling.
CIAMResourceSKU	SKU properties of the Azure AD for customers tenant. Learn more about Azure AD for customers billing at https://aka.ms/ciambilling.
CIAMResourceSKUName	The name of the SKU for the tenant.
CIAMResourceSKUTier	The tier of the tenant.
CIAMTenantResource	The Azure AD for customers resource.
ciamTypeValue	The type of the Azure AD for customers tenant resource.
createdByType	The type of identity that created the resource.
ErrorAdditionalInfo	The resource management error additional info.
ErrorDetail	The error detail.
ErrorResponse	Error response
ProvisioningState	Provisioning State
systemData	Metadata pertaining to creation and last modification of the resource.

ciamBillingType

Enumeration

The type of billing. Will be MAU for all new customers. Cannot be changed if value is 'MAU'. Learn more about Azure AD for customers billing at aka.ms/b2cBilling.

Value	Description
MAU	Azure AD for customers usage is billed to a linked Azure subscription and uses a monthly active users (MAU) billing model.

CIAMResourceSKU

Object

SKU properties of the Azure AD for customers tenant. Learn more about Azure AD for customers billing at https://aka.ms/ciambilling.

Name	Type	Description
name	CIAMResourceSKUName	The name of the SKU for the tenant.
tier	CIAMResourceSKUTier	The tier of the tenant.

CIAMResourceSKUName

Enumeration

The name of the SKU for the tenant.

Value	Description
Standard
PremiumP1
PremiumP2

CIAMResourceSKUTier

Enumeration

The tier of the tenant.

Value	Description
A0	The SKU tier used for all Azure AD for customers tenants.

CIAMTenantResource

Object

The Azure AD for customers resource.

Name	Type	Description
id	string	An identifier that represents the Azure AD for customers tenant resource.
location	string	The location in which the resource is hosted and data resides. Can be one of 'United States', 'Europe', 'Asia Pacific', or 'Australia'. Refer to this documentation for more information.
name	string	The name of the Azure AD for customers tenant resource.
properties.billingConfig.billingType	ciamBillingType	The type of billing. Will be MAU for all new customers. Cannot be changed if value is 'MAU'. Learn more about Azure AD for customers billing at aka.ms/b2cBilling.
properties.billingConfig.effectiveStartDateUtc	string	The data from which the billing type took effect
properties.createTenantProperties.countryCode	string	Country code of Azure tenant (e.g. 'US'). Refer to https://aka.ms/ciam-data-location to see valid country codes and corresponding data residency locations. If you do not see a country code in an valid data residency location, choose one from the list.
properties.createTenantProperties.displayName	string	The display name of the Azure AD for customers tenant.
properties.domainName	string	The domain name of the tenant
properties.provisioningState	ProvisioningState	Provisioning State
properties.tenantId	string	An identifier of the Azure AD for customers tenant.
sku	CIAMResourceSKU	SKU properties of the Azure AD for customers tenant. Learn more about Azure AD for customers billing at https://aka.ms/ciambilling.
systemData	systemData	Metadata pertaining to creation and last modification of the resource.
tags	object	Resource Tags
type	ciamTypeValue	The type of the Azure AD for customers tenant resource.

ciamTypeValue

Enumeration

The type of the Azure AD for customers tenant resource.

Value	Description
Microsoft.AzureActiveDirectory/ciamDirectories	The resource type for Azure AD for customers tenant resource.

createdByType

Enumeration

The type of identity that created the resource.

Value	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

ErrorDetail

Object

The error detail.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	ErrorDetail[]	The error details.
message	string	The error message.
target	string	The error target.

ErrorResponse

Object

Error response

Name	Type	Description
error	ErrorDetail	The error object.

ProvisioningState

Enumeration

Provisioning State

Value	Description
Succeeded
Failed
Canceled
Provisioning
Deleting
Deleted

systemData

Object

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string (date-time)	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string (date-time)	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.

Share via

CIAM Tenants - Create

URI Parameters

Request Body

Responses

Security

azure_auth

Scopes

Examples

Create_CIAM_tenant

Sample request

Sample response

Definitions

ciamBillingType

CIAMResourceSKU

CIAMResourceSKUName

CIAMResourceSKUTier

CIAMTenantResource

ciamTypeValue

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningState

systemData