---
title: "Create a RecordA object."
method: POST
path: "/record:a"
tags: ["record:a"]
---

# Create a RecordA object.

`POST /record:a`

## Request

- Base URL: `https://csp.infoblox.com/wapi/v3`
- URL: `https://csp.infoblox.com/wapi/v3/record:a`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/infoblox/apis/dns-data-web-api/docs/record:a/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this method to create a __RecordA__ object.

## Request body

- V3RecordA: A __RecordA__ object (_dns/record_) represents a DNS resource record in an authoritative zone. For creating a DNS resource record, following pair of fields is required:<ul><li>_ipv4addr_ and _name_: The system creates the DNS resource record object within the zone embedded in the name field. If no value of the view field is provided, default view is used automatically.</li></ul> The _ipv4addr_ and _name_ fields can be modified while updating a DNS resource record.
  - `comment` string: Comment for the RecordA; maximum 1024 characters.
  - `creator` string: Creator for the RecordA. Note that changing creator from or to 'SYSTEM' value is not allowed.
  - `disable` boolean: Determines if the RecordA is disabled or not. False means that the RecordA is enabled.
  - `ipv4addr` string, required: The IPv4 Address of the RecordA.
  - `name` string, required: Name for the RecordA in FQDN format. This value can be in unicode format.
  - `ref` string: infoblox.ddi.wapi.objectref
  - `tags` object: The tags for the RecordA in JSON format.
  - `ttl` integer: The Time To Live (TTL) value for record. A 32-bit unsigned integer that represents the duration, in seconds, for which the RecordA is valid (cached). Zero indicates that the RecordA should not be cached.
  - `use_ttl` boolean: Use flag for: _ttl_. If set to _true_, the TTL value is used for the record. If set to _false_, the TTL value is inherited from the zone.
  - `view` string: The name of the DNS view in which the RecordA resides. Example: "external".
  - `zone` string: The name of the zone in which the RecordA resides. Example: "zone.com". If a view is not specified when searching by zone, the default view is used.

## Response `201`

POST operation response

- string: infoblox.ddi.wapi.objectref

---

[API](https://skmtc.dev/infoblox/apis/dns-data-web-api.md) - [All operations](https://skmtc.dev/infoblox/apis/dns-data-web-api/llms.txt) - [OpenAPI document](https://skmtc.dev/infoblox/apis/dns-data-web-api/revisions/b4b272e5590c?raw)