---
title: "POST /businessdomains"
method: POST
path: "/businessdomains"
tags: ["BusinessDomain"]
---

# POST /businessdomains

`POST /businessdomains`

## Request

- Base URL: `{endpoint}/datagovernance/catalog`
- URL: `{endpoint}/datagovernance/catalog/businessdomains`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `https://purview.azure.net/.default`

Creates a new business domain. Rate limit: 200 requests per 20-second window.

## Query parameters

- `api-version` string, required

## Request body

- Domain: Catalog model domain.
  - `status` 'DRAFT' | 'PUBLISHED' | 'EXPIRED': Status of a catalog model entity indicating its lifecycle state.
  - `type` 'FunctionalUnit' | 'LineOfBusiness' | 'DataDomain' | 'Regulatory' | 'Project': CatalogModelDomainTypeEnum
  - `id` string, uuid, required: Universally Unique Identifier
  - `name` string: The name of the domain.
  - `isRestricted` boolean: Whether the domain is restricted.
  - `systemData` CatalogModelSystemDataWithExpired, required: System metadata with expiration information for catalog entities.
    - `provisioningState` 'Unknown' | 'Succeeded' | 'SoftDeleted': The provisioning state of a data asset.
    - `createdAt` string, date-time: The timestamp when the record was created.
    - `createdBy` string, uuid: Universally Unique Identifier
    - `lastModifiedAt` string, date-time: The timestamp when the record was last modified.
    - `lastModifiedBy` string, uuid: Universally Unique Identifier
    - `expiredAt` string, date-time: The timestamp when the record expires.
    - `expiredBy` string, uuid: Universally Unique Identifier
  - `description` string: The description of the domain.
  - `parentId` string, uuid, required: Universally Unique Identifier
  - `thumbnail` CatalogModelDomainAllOfThumbnail, required: Catalog model domain thumbnail properties.
    - `color` string: The color of the thumbnail.
  - `domains` CatalogModelPlatformDomain[], required: The list of platform domains.
    - `name` string: The name of the platform domain.
    - `friendlyName` string: The friendly name of the platform domain.
    - `relatedCollections` CatalogModelRelatedCollection[]: The related collections of the platform domain.
      - `name` string: The name of the related collection.
      - `friendlyName` string: The friendly name of the related collection.
      - `parentCollection` CatalogModelRelatedCollectionParentCollection: Catalog model related collection parent collection.
        - `type` 'CollectionReference': Related collection parent collection type enumeration.
        - `refName` string: The reference name of the parent collection.
  - `managedAttributes` CatalogModelManagedAttribute[], required: The managed attributes associated with the domain.
    - `name` string: The name of the managed attribute.
    - `value` string: The value of the attribute.
    - `isRequired` boolean: Whether this attribute is required.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- Domain: Catalog model domain.
  - `status` 'DRAFT' | 'PUBLISHED' | 'EXPIRED': Status of a catalog model entity indicating its lifecycle state.
  - `type` 'FunctionalUnit' | 'LineOfBusiness' | 'DataDomain' | 'Regulatory' | 'Project': CatalogModelDomainTypeEnum
  - `id` string, uuid, required: Universally Unique Identifier
  - `name` string: The name of the domain.
  - `isRestricted` boolean: Whether the domain is restricted.
  - `systemData` CatalogModelSystemDataWithExpired, required: System metadata with expiration information for catalog entities.
    - `provisioningState` 'Unknown' | 'Succeeded' | 'SoftDeleted': The provisioning state of a data asset.
    - `createdAt` string, date-time: The timestamp when the record was created.
    - `createdBy` string, uuid: Universally Unique Identifier
    - `lastModifiedAt` string, date-time: The timestamp when the record was last modified.
    - `lastModifiedBy` string, uuid: Universally Unique Identifier
    - `expiredAt` string, date-time: The timestamp when the record expires.
    - `expiredBy` string, uuid: Universally Unique Identifier
  - `description` string: The description of the domain.
  - `parentId` string, uuid, required: Universally Unique Identifier
  - `thumbnail` CatalogModelDomainAllOfThumbnail, required: Catalog model domain thumbnail properties.
    - `color` string: The color of the thumbnail.
  - `domains` CatalogModelPlatformDomain[], required: The list of platform domains.
    - `name` string: The name of the platform domain.
    - `friendlyName` string: The friendly name of the platform domain.
    - `relatedCollections` CatalogModelRelatedCollection[]: The related collections of the platform domain.
      - `name` string: The name of the related collection.
      - `friendlyName` string: The friendly name of the related collection.
      - `parentCollection` CatalogModelRelatedCollectionParentCollection: Catalog model related collection parent collection.
        - `type` 'CollectionReference': Related collection parent collection type enumeration.
        - `refName` string: The reference name of the parent collection.
  - `managedAttributes` CatalogModelManagedAttribute[], required: The managed attributes associated with the domain.
    - `name` string: The name of the managed attribute.
    - `value` string: The value of the attribute.
    - `isRequired` boolean: Whether this attribute is required.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-07-13** (2025-09-15-preview) `4928fc2e3948`: 1 info
  - api operation id `CreateDomain` removed and replaced with `BusinessDomain_Create`
- **2025-10-01** (2025-09-15-preview) `a588e84c8390`: 1 info
  - api operation id `BusinessDomain_Create` removed and replaced with `CreateDomain`

[Operation history](https://skmtc.dev/azure/apis/purviewdatagovernance-azure-analytics-purview-unifiedcatalog/changes/businessdomains/post.md)

---

[API](https://skmtc.dev/azure/apis/purviewdatagovernance-azure-analytics-purview-unifiedcatalog.md) - [All operations](https://skmtc.dev/azure/apis/purviewdatagovernance-azure-analytics-purview-unifiedcatalog/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/purviewdatagovernance-azure-analytics-purview-unifiedcatalog/revisions/70d32c954a8c?raw)