> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisdom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Domain

The `createDomain` mutation creates a new domain with a name and optional description.

## Signature

```graphql theme={null}
createDomain(input: CreateDomainInput!): DomainModel!
```

<Note>
  This mutation can only be executed by an administrator or a data administrator of the specific domain ID.
</Note>

## Arguments

<ParamField path="input" type="CreateDomainInput!" required>
  Input object containing domain creation parameters. See [CreateDomainInput](#createdomaininput).
</ParamField>

### CreateDomainInput

<ParamField path="name" type="String!" required>
  The name of the domain. Must be unique within your organization.
</ParamField>

<ParamField path="description" type="String">
  Optional description explaining the purpose and contents of the domain.
</ParamField>

<ParamField path="workspaceID" type="ID">
  The workspace ID in which to create the domain. Defaults to the current workspace if not specified.
</ParamField>

## Response

Returns a `DomainModel` object representing the newly created domain. See [DomainModel](/integrations/graphql-api/objects/domain-model) for the schema.

## Usage example

Create a domain for organizing sales-related data sources:

```graphql theme={null}
mutation CreateDomain($input: CreateDomainInput!) {
  createDomain(input: $input) {
    id
    version
    name
    description
  }
}
```

<RequestExample>
  ```bash Request theme={null}
  curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <jwt_token>" \
    -d '{
      "query": "mutation CreateDomain($input: CreateDomainInput!) { createDomain(input: $input) { id name description } }",
      "variables": {
        "input": {
          "name": "Sales Analytics",
          "description": "Customer data, transactions, and sales performance metrics"
        }
      }
    }' \
    https://{ACCOUNT}.askwisdom.ai/graphql
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "createDomain": {
        "id": "ET_DOMAIN_id-here",
        "name": "Sales Analytics",
        "description": "Customer data, transactions, and sales performance metrics"
      }
    }
  }
  ```
</ResponseExample>

## Related operation

<CardGroup cols={2}>
  <Card title="DomainModel Schema" icon="folder" href="/integrations/graphql-api/objects/domain-model">
    Learn about domain structure and properties
  </Card>
</CardGroup>