---
title: "Creates a domain"
method: PUT
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}"
tags: ["Domains"]
---

# Creates a domain

`PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

## Path parameters

- `resourceGroupName` string, required
- `domainName` string, required
- `subscriptionId` string, required

## Query parameters

- `api-version` string, required

## Request body

- Domain
  - `id` string: Resource Id
  - `name` string: Resource Name
  - `kind` string: Kind of resource
  - `location` string, required: Resource Location
  - `type` string: Resource type
  - `tags` object: Resource tags

## Response `200`

Domain purchase was successful

- Domain
  - `id` string: Resource Id
  - `name` string: Resource Name
  - `kind` string: Kind of resource
  - `location` string, required: Resource Location
  - `type` string: Resource type
  - `tags` object: Resource tags

## Other responses

- `202`: Domain purchase is in progress

---

[API](https://skmtc.dev/azure/apis/website-management-client.md) - [All operations](https://skmtc.dev/azure/apis/website-management-client/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/website-management-client/revisions/e6d8fbd68044?raw)