DNSFilter n8n Node

Note: If you are a distributor integrating with DNSFilter, please check out our Distributors Development Guide.### Authentication- Authentication is required for most, but not all, endpoints.- Authentication is done by setting the Authorization request header. The header value is the API key itself. For example: Authorization: eyJ...- An API key can be obtained through the DNSFilter dashboard under Account Settings. For additional information see this KB article.### Rate Limiting- All endpoints are rate limited.- The limits may vary by endpoint, but are generally consistent.- When the rate limit is exceeded the API will return the standard 429 HTTP status.- The following headers will also be provided in the response: Retry-After, RateLimit-Policy, RateLimit, RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset. For details on the values of these headers, see the following articles here, here, and here.- For additional information see this KB article.### Error Handling- The API uses standard HTTP status codes to indicate success or failure.- For V1 endpoints the response format is: json { "error": "string", "type": "string(optional)" } - For V2 endpoints the response format is: json { "error": { "message": "string", "type": "string(optional)" } } ### PaginationFor the V1 endpoints, the pagination parameters are nested. That is to say,if passed as JSON they look like this: {"page[number]": 1, "page[size]": 10}.To pass this information in the URL query string, it would be formatted likethis: ...?page%5Bnumber%5D=1&page%5Bsize%5D=10.In this guide, the UI will indicate that page is an object and if youwant to set values when trying the request, you must enter it as if it wasthe JSON above.### A Quick ExampleThe following will return information about the currentlyauthenticated user.bash% curl -H 'Authorization: ***' https://api.dnsfilter.com/v1/users/self{ "data": { "id": "12345", "type": "users", "attributes": { "name": "John Doe", "email": "john@example.com", ...additional fields...}}}

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-dnsfilter

Authentication

This node authenticates using an API Key.

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

Resources & Operations

Base URL: https://api.dnsfilter.com

AgentLocalUserBulkDeletes

AgentLocalUsers

ApiKeys

ApplicationCategories

Applications

Billings

BlockPages

Categories

CollectionUsers

User(Current)

DictionaryLookups

Distributors

DomainNotes

Domains

EnterpriseConnections

Invoices

IPAddresses

MACAddresses

Metrics

NetworkLANIPs

NetworkSubnets

Networks

OrganizationUsers

Organizations

PoliciesBulkActions

Policies

PolicyIPs

PSAIntegrations

ScheduledPolicies

ScheduledReportPreviews

ScheduledReports

TrafficReports

Trials

UserAgentBulkDeletes

UserAgentBulkUpdates

UserAgentCleanups

UserAgentCSVExports

UserAgentReleases

UserAgents

Users

UserUISettingsV2

CybersightCSVExports

NetworksCSVExports

Compatibility

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

License

MIT