## Create DNS Record `dns.records.create(RecordCreateParams**kwargs) -> RecordResponse` **post** `/zones/{zone_id}/dns_records` Create a new DNS record for a zone. Notes: - A/AAAA records cannot exist on the same name as CNAME records. - NS records cannot exist on the same name as any other record type. - Domain names are always represented in Punycode, even if Unicode characters were used when creating the record. ### Parameters - `zone_id: str` Identifier. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `ttl: TTLParam` Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. - `float` - `Literal[1]` Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. - `1` - `type: Literal["A"]` Record type. - `"A"` - `include_shadow_metadata: Optional[bool]` Whether to include shadow metadata in the `meta` field of each record in the response. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv4 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[ARecordSettings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. - `ipv6_only: Optional[bool]` When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. - `tags: Optional[Sequence[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### Returns - `RecordResponse` - `class ARecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: ARecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAARecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: AAAARecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAMERecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: CNAMERecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MXRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: MXRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NSRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: NSRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class OpenpgpkeyRecord: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: OpenpgpkeyRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeyRecordSettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. - `ipv6_only: Optional[bool]` When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `ttl: TTL` Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. - `float` - `Literal[1]` Time To Live (TTL) of the DNS record in seconds. Setting to 1 means 'automatic'. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTRRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: PTRRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXTRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: TXTRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAARecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: CAARecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERTRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: CERTRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEYRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: DNSKEYRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DSRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: DSRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPSRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: HTTPSRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOCRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: LOCRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTRRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: NAPTRRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEARecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: SMIMEARecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRVRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: SRVRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFPRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: SSHFPRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCBRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: SVCBRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSARecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: TLSARecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URIRecord: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: URIRecordMeta` Extra Cloudflare-specific metadata about the record. - `dead_glue: Optional[bool]` Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only `is_glue`. See [Unreachable glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `is_glue: Optional[bool]` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `shadowed_by: Optional[List[str]]` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `shadowed_records_count: Optional[int]` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) record_response = client.dns.records.create( zone_id="023e105f4ecef8ad9ca31a8372d0c353", name="example.com", ttl=3600, type="A", ) print(record_response) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": { "dead_glue": true, "is_glue": true, "shadowed_by": [ "372e67954025e0ba6aaa6d586b9e0b59" ], "shadowed_records_count": 42 }, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } } ```