DMARC Report n8n Node

API documentation for DMARC Report v2. Provides endpoints for managing accounts, domains, aggregate reports, forensic (failure) reports, MTA-STS reports, postmaster account records, and account members.

Table of Contents

• Installation
• Authentication
• Resources & Operations
• Compatibility
• License

Installation

Follow the n8n community node installation guide.

Or install directly via npm:

npm install @avantguardllc/n8n-nodes-dmarcreport

Authentication

This node authenticates using an API Key.

| Setting | Value | |---------|-------| | Type | API Key | | Base URL | https://api.dmarcreport.com/v2 (editable in credentials) |

Tip: The Base URL can be changed in the credential settings if your instance uses a different host.

Resources & Operations

Base URL: https://api.dmarcreport.com/v2

Accounts

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /accounts | List accounts | | 🟢 POST | /accounts.json | Add account | | 🟡 PUT | /accounts/{id}.json | Update account | | 🔴 DELETE | /accounts/{id}.json | Delete account |

Domains

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /all_domains.json | List all domains across all accounts | | 🔵 GET | /accounts/{account_id}/domains.json | List all domains in a given account | | 🟢 POST | /accounts/{account_id}/domains.json | Add a domain | | 🔵 GET | /accounts/{account_id}/domains/{id}.json | Get all the details of a domain | | 🟡 PUT | /accounts/{account_id}/domains/{id}.json | Update domain settings | | 🔴 DELETE | /accounts/{account_id}/domains/{id}.json | Delete a domain | | 🔵 GET | /accounts/{account_id}/domains/{id}/hosted_services.json | Get hosted services status and CNAME records | | 🟢 POST | /accounts/{account_id}/domains/{id}/verify_hosted_dmarc.json | Verify hosted DMARC setup status | | 🟢 POST | /accounts/{account_id}/domains/{id}/verify_hosted_mta_sts.json | Verify hosted MTA-STS setup status | | 🟢 POST | /accounts/{account_id}/domains/{id}/generate_dmarc_record.json | Generate a DMARC record |

AccountDomains

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /accounts/{account_id}/domain_accounts | List domain accounts | | 🔵 GET | /accounts/{account_id}/domain_accounts/{id} | Details of domain account | | 🟢 POST | /accounts/{account_id}/domain_accounts.json | Add domains in account | | 🔴 DELETE | /accounts/{account_id}/domain_accounts/{domain_accounts_id}.json | Delete domain from account |

AggregateReports

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /accounts/{account_id}/domains/{domain_id}/agg_reports.json | List, search, and paginate aggregate reports | | 🔵 GET | /accounts/{account_id}/domains/{domain_id}/agg_reports/records.json | Get aggregate report records | | 🔵 GET | /accounts/{account_id}/domains/{domain_id}/agg_reports/{id}.json | Get all the details of an aggregate report | | 🔵 GET | /accounts/{account_id}/domains/{domain_id}/agg_reports/agg_report_stats | Get aggregate report stats of domain |

ForensicReports

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /accounts/{account_id}/domains/{domain_id}/forensic_reports.json | List, search, and paginate failure reports | | 🔵 GET | /accounts/{account_id}/domains/{domain_id}/forensic_reports/{id}.json | Get all the details of a failure report |

MTASTSReports

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /accounts/{account_id}/domains/{domain_id}/mta_sts_reports.json | List, search, and paginate MTA-STS reports | | 🔵 GET | /accounts/{account_id}/domains/{domain_id}/mta_sts_reports/mta_failure_details.json | List MTA-STS failure details | | 🔵 GET | /accounts/{account_id}/domains/{domain_id}/mta_sts_reports/{id}.json | Get all the details of an MTA-STS report |

PostmasterAccountRecords

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /postmaster_account_records.json | Cumulative data of all domains of a Postmaster Account | | 🔵 GET | /postmaster_account_records/{id}.json | Details of a Postmaster Account domain | | 🔵 GET | /postmaster_account_records/connected.json | List connected Postmaster Accounts |

AccountMembers

| | Endpoint | Description | |---|----------|-------------| | 🔵 GET | /accounts/{account_id}/user_accounts | List user accounts | | 🔵 GET | /accounts/{account_id}/user_accounts/{id} | Details of user account | | 🟢 POST | /accounts/{account_id}/user_accounts.json | Add user in account | | 🟡 PUT | /accounts/{account_id}/user_accounts/{id}.json | Update user in account | | 🔴 DELETE | /accounts/{account_id}/user_accounts/{id}.json | Delete user from account |

Compatibility

• n8n version: 1.0+ (tested on 2.x)
• Node.js version: 18+

License

MIT