Skip to main content

Zones

Retrieves zone data from Cloudflare for DNS and domain mapping. This input collects information about all zones (domains) associated with your Cloudflare account, including their status, DNS servers, configuration, and plan details.

Sync Type: Full Synchronization

Requirements

  • A Cloudflare account with API access
  • An API Token with Zone:Read permission
  • Your Cloudflare Account ID (optional, but recommended for better organization)

Creating an API Token

  1. Log in to your Cloudflare dashboard
  2. Navigate to My Profile > API Tokens
  3. Click Create Token
  4. Use the Create Custom Token option
  5. Configure the token:
    • Token name: Give it a descriptive name (e.g., "Monad Zones")
    • Permissions: Add Zone > Zone > Read
    • Zone Resources: Select the specific zone(s) or "All zones"
  6. Click Continue to summary and then Create Token
  7. Copy the token value (you won't be able to see it again)

Details

Monad uses the cron field to run this input on specific intervals and returns all zones, performing a full sync of data each time. The input retrieves comprehensive zone information including:

  • Zone status and configuration
  • DNS server information (both Cloudflare and original nameservers)
  • Zone type (full setup, nameserver only, or partial setup)
  • Associated plan and account information
  • Zone metadata and permissions

The input uses paginated API requests with up to 50 zones per page to efficiently retrieve all zone data.

Configuration

The following configuration defines the input parameters. Each field's specifications, such as type, requirements, and descriptions, are detailed below.

Settings

SettingTypeRequiredDescription
CronstringYesCron string for scheduling the ingest of your input. Example: '0 0 * * *' for daily execution at midnight.

Secrets

SecretTypeRequiredDescription
API TokenstringYesYour Cloudflare API token with Zone:Read permission

Rate Limits

ScopeLimitWindowNotes
API Requests1,200per 5 minutesStandard rate limit across Cloudflare API

Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset Source: Cloudflare API Rate Limits

Sample Record

{
"id": "023e105f4ecef8ad9ca31a8372d0c353",
"name": "example.com",
"status": "active",
"paused": false,
"type": "full",
"development_mode": 0,
"name_servers": [
"bob.ns.cloudflare.com",
"iris.ns.cloudflare.com"
],
"original_name_servers": [
"ns1.originaldnshost.com",
"ns2.originaldnshost.com"
],
"original_registrar": "GoDaddy",
"original_dnshost": null,
"modified_on": "2024-01-15T10:30:00Z",
"created_on": "2024-01-01T00:00:00Z",
"activated_on": "2024-01-02T00:00:00Z",
"vanity_name_servers": [],
"vanity_name_servers_ips": [],
"meta": {
"step": 4,
"custom_certificate_quota": 5,
"page_rule_quota": 50,
"phishing_detected": false
},
"owner": {
"id": "7c5dae5054a8dff9ca6baea1e6e6a9cb",
"type": "organization",
"name": "Example Organization"
},
"account": {
"id": "9a7e1204ce5e67c06ba30a151c740d38",
"name": "Example Account"
},
"tenant": {
"id": null,
"name": null
},
"tenant_unit": {
"id": null
},
"permissions": [
"#zone:read",
"#dns_records:read",
"#ssl:read"
],
"plan": {
"id": "e592fd9519420ba7405e1307bff33b8b",
"name": "Pro",
"price": 20,
"currency": "USD",
"frequency": "monthly",
"is_subscribed": true,
"can_subscribe": true,
"legacy_id": "pro",
"legacy_discount": false,
"externally_managed": false
}
}