# Zuplo CLI: Custom Domain Create

<CliCommand
  command="custom-domain create"
  description="Creates a custom domain in your account"
  options={[
  {
    "name": "hostname",
    "type": "string",
    "description": "The hostname for the custom domain",
    "required": false,
    "deprecated": false,
    "hidden": false
  },
  {
    "name": "deployment-name",
    "type": "string",
    "description": "The deployment name to assign the custom domain to",
    "required": false,
    "deprecated": false,
    "hidden": false
  },
  {
    "name": "custom-domain-type",
    "type": "string",
    "description": "The type of custom domain to create. Defaults to api server-side.",
    "required": false,
    "deprecated": false,
    "hidden": false,
    "choices": [
      "api",
      "dev-portal"
    ]
  },
  {
    "name": "account",
    "type": "string",
    "description": "The account name",
    "required": false,
    "deprecated": false,
    "hidden": false
  },
  {
    "name": "output",
    "type": "string",
    "description": "Output format",
    "default": "default",
    "required": false,
    "deprecated": false,
    "hidden": false,
    "alias": [
      "o"
    ],
    "choices": [
      "default",
      "json"
    ]
  }
]}
  examples={[
  [
    "$0 custom-domain create --hostname api.example.com",
    "Create an unassigned custom domain"
  ],
  [
    "$0 custom-domain create --hostname api.example.com --output json",
    "Create a custom domain and output the result as JSON"
  ],
  [
    "$0 custom-domain create \\\n  --hostname api.example.com \\\n  --deployment-name production-deployment",
    "Create and assign a custom domain to a deployment"
  ],
  [
    "$0 custom-domain create \\\n  --hostname docs.example.com \\\n  --deployment-name production-deployment \\\n  --custom-domain-type dev-portal \\\n  --account my-account",
    "Create a dev portal custom domain on a specific account"
  ]
]}
  usage="$0 custom-domain create --hostname <hostname> [options]"
>

</CliCommand>

## Global options

The following global options are available for all commands:

- [`--help`](./global-options.mdx#help)
- [`--api-key`](./global-options.mdx#api-key)