# record-create

The dns record-create command adds a new DNS record to a specific DNS zone.This command requires the DNS zone ID and record details, including record type, name, content, and TTL.

## Usage

```
cldkctl dns record-create [id] [flags]
```

## Steps

Follow the steps below to run and view the result of this command:

1. Run the following command in your terminal:

```
cldkctl dns record-create [dns-zone-id] --type [record-type] --name [record-name] --content [record-content] --ttl [record-ttl]
```

2. Replace `[dns-zone-id]` with the ID of the DNS zone. Refer to dns list section to obtain the DNS zone ID.
3. Replace `[record-type]` with the DNS record type.
4. Replace `[record-name]` with the record name.
5. Replace `[record-content]` with the record value.
6. Replace `[record-ttl]` with the desired TTL (time to live) value.
7. Or alternatively, run the command without flags to create a DNS record interactively using TUI mode:

```
cldkctl dns record-create [dns-zone-id]
```

8. Select the DNS record type from the list.
9. Enter the record name when prompted.

<figure><img src="/files/EQztxgzgUpjQLrzXzeIb" alt=""><figcaption></figcaption></figure>

10. Enter the record content when prompted.
11. Enter the TTL value or press Enter to use the default value (86400).

<figure><img src="/files/qsR2I4eO4N2W6WYQRMk8" alt=""><figcaption></figcaption></figure>

12. Confirm the record creation by pressing y for Confirm or n for Cancel.

<figure><img src="/files/ssZblTmp815mP9IE8GFi" alt=""><figcaption></figcaption></figure>

13. Once completed successfully, a message **“✓ DNS record created successfully!”** will appear in the terminal.

<figure><img src="/files/1PYOwrgAJ7YG3A5f9eGk" alt=""><figcaption></figcaption></figure>

## Flags

{% hint style="info" %}
This command supports [global flags](/guidance-for-individual/cloudeka-api-list/global-flags.md). Refer to the Global Flags section for details.
{% endhint %}

| Flag                 | Description                                    |
| -------------------- | ---------------------------------------------- |
| -c, --content string | DNS record content.                            |
| -h, --help           | Help for dns record create command.            |
| -n, --name string    | DNS record name.                               |
| --ttl int            | DNS record TTL (time to live) (default 86400). |
| -t, --type string    | DNS record type.                               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudeka.ai/guidance-for-individual/cloudeka-api-list/command-reference/cldkctl-dns/record-create.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.