--- title: Configure DMARC Reports --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Email Auth](https://developers.cloudflare.com/api/python/resources/email_auth) [DMARC Reports](https://developers.cloudflare.com/api/python/resources/email_auth/subresources/dmarc_reports) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Configure DMARC Reports email\_auth.dmarc\_reports.edit(DMARCReportEditParams\*\*kwargs) -> [DMARCReportEditResponse]() PATCH/zones/{zone\_id}/email/auth/dmarc-reports Updates the DMARC report configuration for a zone. At least one of `enabled` or `skip_wizard` must be provided. When enabling, the handler will ensure the DMARC RUA record exists in DNS. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### ParametersExpand Collapse zone\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20email_auth.dmarc_reports%20%3E%20(method)%20edit%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>) enabled: Optional\[bool] Enable or disable DMARC reports for this zone [Link to this property](<#(resource)%20email_auth.dmarc_reports%20%3E%20(method)%20edit%20%3E%20(params)%20default%20%3E%20(param)%20enabled%20%3E%20(schema)>) skip\_wizard: Optional\[bool] Skip the DMARC setup wizard [Link to this property](<#(resource)%20email_auth.dmarc_reports%20%3E%20(method)%20edit%20%3E%20(params)%20default%20%3E%20(param)%20skip_wizard%20%3E%20(schema)>) ##### ReturnsExpand Collapse

class DMARCReportEditResponse: … Response for GET/PATCH /dmarc-reports

approved\_sources: Optional\[List\[ApprovedSource]] List of approved sending sources (omitted when empty)

Deprecatedcreated: Optional\[datetime] Use created_at instead. Deprecated, use created\_at formatdate-time Link to this property created\_at: Optional\[datetime] Creation timestamp formatdate-time Link to this property domain: Optional\[str] The source domain Link to this property ips: Optional\[List\[str]] Resolved IP addresses from SPF Link to this property Deprecatedmodified: Optional\[datetime] Use modified_at instead. Deprecated, use modified\_at formatdate-time Link to this property modified\_at: Optional\[datetime] Last modification timestamp formatdate-time Link to this property name: Optional\[str] Source name (typically same as domain) Link to this property slug: Optional\[str] URL-friendly identifier Link to this property tag: Optional\[str] Source UUID Link to this property

Link to this property Deprecatedcreated: Optional\[datetime] Use created_at instead. Deprecated, use created\_at formatdate-time Link to this property created\_at: Optional\[datetime] Creation timestamp formatdate-time Link to this property enabled: Optional\[bool] Whether DMARC reports are enabled Link to this property Deprecatedmodified: Optional\[datetime] Use modified_at instead. Deprecated, use modified\_at formatdate-time Link to this property modified\_at: Optional\[datetime] Last modification timestamp formatdate-time Link to this property

records: Optional\[Records] Live DNS records for the zone, grouped by type

bimi\_records: Optional\[List\[RecordsBimiRecord]] BIMI TXT records

id: Optional\[str] DNS record ID Link to this property content: Optional\[str] Record content Link to this property name: Optional\[str] DNS record name Link to this property resolved: Optional\[List\[str]] For a CNAME record, the TXT content(s) found by following the CNAME chain to its target. An empty array means the chain was resolved but nothing usable was found there; omitted/null means resolution was not attempted for this record (always the case for non-CNAME entries). A CNAME chain that terminates in more than one TXT value at the target yields multiple entries. Populated on entries in cname\_dmarc\_records, cname\_spf\_records, and cname\_dkim\_records. Link to this property ttl: Optional\[int] Time to live in seconds Link to this property type: Optional\[str] Record type Link to this property

Link to this property

cname\_dkim\_records: Optional\[List\[RecordsCnamedkimRecord]] CNAME records for DKIM selectors. Each selector is resolved independently; when a selector’s CNAME resolves to a DKIM TXT record, the API returns that record’s content in the resolved field of the corresponding entry.

Link to this property

cname\_dmarc\_records: Optional\[List\[RecordsCnamedmarcRecord]] CNAME records at \_dmarc. When such a CNAME resolves to a DMARC TXT record, the API returns that record’s content in the resolved field of the corresponding entry.

Link to this property

cname\_spf\_records: Optional\[List\[RecordsCnamespfRecord]] CNAME records at the zone apex. When such a CNAME resolves to an SPF TXT record, the API returns that record’s content in the resolved field of the corresponding entry.

Link to this property

dkim\_records: Optional\[List\[RecordsDKIMRecord]] DKIM TXT records

Link to this property

dmarc\_records: Optional\[List\[RecordsDMARCRecord]] DMARC TXT records

Link to this property

Deprecatedresolved\_dmarc\_records: Optional\[List\[RecordsResolvedDMARCRecord]] Use the resolved field on the corresponding entry in cname\_dmarc\_records instead. DMARC records that a recursive lookup of \_dmarc.{zone} returned. The API populates this only when the zone lacks a DMARC TXT record of its own, which usually means a CNAME delegates DMARC to another zone.

content: Optional\[str] The TXT record value. The API joins all character-strings into a single string. Link to this property name: Optional\[str] The name the API queried. Link to this property

Link to this property

spf\_records: Optional\[List\[RecordsSPFRecord]] SPF TXT records

Link to this property

Link to this property rua\_prefix: Optional\[str] Prefix for DMARC RUA addresses (32-char hex string) Link to this property skip\_wizard: Optional\[bool] Whether to skip the setup wizard Link to this property

status: Optional\[Literal\["missing-dmarc-report", "multiple-dmarc-reports", "missing-dmarc-rua", 2 more]] DMARC configuration status. The API omits this field when DMARC is correctly configured. If the zone lacks a DMARC TXT record of its own, the API resolves \_dmarc.{zone} recursively and evaluates whatever that lookup returns. A CNAME at \_dmarc.{zone} that points to a valid DMARC record is therefore healthy; the cname-on-dmarc-record value means the CNAME resolves to no DMARC record at all.

One of the following: "missing-dmarc-report" Link to this property "multiple-dmarc-reports" Link to this property "missing-dmarc-rua" Link to this property "cname-on-dmarc-record" Link to this property "unauthorized-reporting-domain" Link to this property

Link to this property Deprecatedtag: Optional\[str] Use zone_id instead. Use zone_id instead Link to this property zone\_id: Optional\[str] Zone identifier Link to this property

[Link to this property](<#(resource)%20email_auth.dmarc_reports%20%3E%20(model)%20dmarc_report_edit_response%20%3E%20(schema)>) ### Configure DMARC Reports Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.email_auth.dmarc_reports.edit( zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(response.zone_id) ``` 200 example ``` { "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": { "approved_sources": [ { "created": "2024-01-15T10:30:00.12345Z", "created_at": "2024-01-15T10:30:00.12345Z", "domain": "sendgrid.net", "ips": [ "192.168.1.1", "10.0.0.1" ], "modified": "2024-01-15T11:45:00.12345Z", "modified_at": "2024-01-15T11:45:00.12345Z", "name": "SendGrid", "slug": "sendgrid-net", "tag": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415" } ], "created": "2024-01-15T10:30:00.12345Z", "created_at": "2024-01-15T10:30:00.12345Z", "enabled": true, "modified": "2024-01-15T11:45:00.12345Z", "modified_at": "2024-01-15T11:45:00.12345Z", "records": { "bimi_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "cname_dkim_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "cname_dmarc_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "cname_spf_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "dkim_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "dmarc_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "resolved_dmarc_records": [ { "content": "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com" } ], "spf_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ] }, "rua_prefix": "9233c80fc89f43e3a7b749605f651868", "skip_wizard": false, "status": "missing-dmarc-report", "tag": "023e105f4ecef8ad9ca31a8372d0c353", "zone_id": "023e105f4ecef8ad9ca31a8372d0c353" } } ``` ##### Returns Examples 200 example ``` { "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": { "approved_sources": [ { "created": "2024-01-15T10:30:00.12345Z", "created_at": "2024-01-15T10:30:00.12345Z", "domain": "sendgrid.net", "ips": [ "192.168.1.1", "10.0.0.1" ], "modified": "2024-01-15T11:45:00.12345Z", "modified_at": "2024-01-15T11:45:00.12345Z", "name": "SendGrid", "slug": "sendgrid-net", "tag": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415" } ], "created": "2024-01-15T10:30:00.12345Z", "created_at": "2024-01-15T10:30:00.12345Z", "enabled": true, "modified": "2024-01-15T11:45:00.12345Z", "modified_at": "2024-01-15T11:45:00.12345Z", "records": { "bimi_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "cname_dkim_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "cname_dmarc_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "cname_spf_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "dkim_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "dmarc_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ], "resolved_dmarc_records": [ { "content": "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com" } ], "spf_records": [ { "id": "e5bb46707a802688812d5d1c9f7977d4", "content": "v=DMARC1; p=none; rua=mailto:rua@dmarc-reports.cloudflare.net", "name": "_dmarc.example.com", "resolved": [ "v=DMARC1; p=reject; rua=mailto:rua@dmarc-reports.cloudflare.net" ], "ttl": 300, "type": "TXT" } ] }, "rua_prefix": "9233c80fc89f43e3a7b749605f651868", "skip_wizard": false, "status": "missing-dmarc-report", "tag": "023e105f4ecef8ad9ca31a8372d0c353", "zone_id": "023e105f4ecef8ad9ca31a8372d0c353" } } ```