With the Cloudflare integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more], you can keep your Cloudflare DNS records up to date.

The integration runs every hour, but can also be triggered by running the cloudflare.update_records service.


The setup requires an API Token created with Zone:Zone:Read and Zone:DNS:Edit permissions for all zones in your account.

An easy way to create this is to start with the “Edit zone DNS” template then add Zone:Zone:Read to the permissions.

Cloudflare API Tokens Guide


To add the Cloudflare integration to your Home Assistant instance, use this My button:

Additional information

Usage of external service

This integration uses the whoami service from home-assistant/ to set the public IP address.


Unusable TLDs

Due to a limitation in the Cloudflare API, you can not use this integration with any of the following TLD’s:

  • .cf
  • .ga
  • .gq
  • .ml
  • .tk

Record types

This integration can only update A records.


This integration can only have 1 instance and manage 1 Zone/TLD.


This integration must be deleted and re-added to change the Zone and A record selection. You cannot view which records were selected or view the API Token once the integration is configured.