Domain events

Domain events fire when a domain is registered, renewed, or modified in any way — including DNS, contacts, forwarding, and privacy settings.

See Using Webhooks for the full payload structure, which is shared across every event type.

Event typeDisplay nameDescription
registerDomain registrationA domain was registered (sent on both success and failure)
renewDomain renewalA domain was renewed
modifyDomain updateA domain record was updated
add_privacyAdd contact privacyContact privacy was added to a domain
renew_privacyRenew contact privacyContact privacy was renewed
enable_autorenewEnable domain auto-renewAuto-renew was turned on
disable_autorenewDisable domain auto-renewAuto-renew was turned off
enable_lockEnable domain lockTransfer lock was enabled
disable_lockDisable domain lockTransfer lock was disabled
update_contactUpdate contactA domain contact was updated
enable_privacy_autorenewEnable contact privacy auto-renewContact privacy auto-renew was enabled
disable_privacy_autorenewDisable contact privacy auto-renewContact privacy auto-renew was disabled
enable_privacyEnable contact privacyContact privacy was enabled
disable_privacyDisable contact privacyContact privacy was disabled
update_nameserversUpdate nameserversNameservers were changed
add_forwardingAdd domain forwardingDomain forwarding was configured
update_forwardingUpdate domain forwardingDomain forwarding settings were updated
delete_forwardingDelete domain forwardingDomain forwarding was removed
add_dnsAdd DNS recordA DNS record was added
update_dnsUpdate DNS recordA DNS record was updated
delete_dnsDelete DNS recordA DNS record was deleted
reset_dnsReset DNS recordsDNS records were reset to default
update_dns_templateUpdate DNS templateA DNS template was applied or changed
transferTransfer domainA domain transfer was initiated or completed
importImport domainA domain was imported into Storefront
deleteDelete domainA domain was removed from Storefront
revokeRevoke domainA domain was revoked
revoke_privacyRevoke contact privacyContact privacy was revoked
📘

DNS events currently share one notification type

add_dns, update_dns, delete_dns, and reset_dns are all delivered as Update DNS record, regardless of which DNS operation actually occurred. This is because the underlying API processes all DNS changes through a single bulk endpoint. If your integration needs to distinguish between adding, updating, deleting, or resetting DNS records, you'll need to inspect the data field or your own DNS state rather than relying on the event type alone.

Related articles