Skip to main content
The createDomain mutation creates a new domain with a name and optional description.

​
Signature

createDomain(input: CreateDomainInput!): DomainModel!
This mutation can only be executed by an administrator or a data administrator of the specific domain ID.

​
Arguments

​
input
CreateDomainInput!
required
Input object containing domain creation parameters. See CreateDomainInput.

​
CreateDomainInput

​
name
String!
required
The name of the domain. Must be unique within your organization.
​
description
String
Optional description explaining the purpose and contents of the domain.

​
Response

Returns a DomainModel object representing the newly created domain. See DomainModel for the schema.

​
Usage Example

Create a domain for organizing sales-related data sources: 
mutation CreateDomain($input: CreateDomainInput!) {
  createDomain(input: $input) {
    id
    version
    name
    description
  }
}

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

{
  "data": {
    "createDomain": {
      "id": "ET_DOMAIN_id-here",
      "name": "Sales Analytics",
      "description": "Customer data, transactions, and sales performance metrics"
    }
  }
}

DomainModel Schema

Learn about domain structure and properties