Help Center
Login Sign up
  1. Home
  2. API reference
  3. General API basics
  4. AutoDNS messages
  5. Notification examples

DomainAutoUpdate notifications

API reference (XML/JSON) · Updated 2025-01-02

Here we describe the notifications generated in context of an automatic domain update.

autoupdate_dns_success

 Affects only TLDs with manual processing.

Description

Notification sent upon successful connectivity check.

Notification trigger

The process consists of 2 steps:

Step 1 is acknowledged with status code MSG01055 ("The domain was updated successfully, but the name server update is still pending.").
Step 2 is acknowledged with the notification type autoupdate_dns_success. This completes the manual process.

Recipient of the notification

The recipient of the notification is the AutoDNS user who started the job.

POLLING notification examples

{
    "stid": "20210512-app3-dev-10824",
    "status": {
        "code": "S0905",
        "text": "The notification was polled successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Message",
        "value": "1005491836",
        "summary": 1
    },
    "data": [
        {
            "id": 1005491836,
            "notify": {
                "type": "autoupdate_dns_success"
            },
            "stid": "20210512-app3-dev-10782",
            "object": {
                "type": "Domain",
                "value": "example.aq",
                "data": {
                    "created": "2021-05-12T14:42:26.000+0200",
                    "owner": {
                        "context": 4,
                        "user": "normal_user"
                    },
                    "updater": {
                        "context": 1,
                        "user": "support"
                    },
                    "name": "example.aq",
                    "registryStatus": "ACTIVE",
                    "nameServers": [
                        {
                            "name": "ns1.examplenameserver.com"
                        },
                        {
                            "name": "ns2.examplenameserver.com"
                        }
                    ],
                    "period": {
                        "unit": "YEAR",
                        "period": 1
                    },
                    "registrarStatus": "ACTIVE",
                    "rddsOptIn": "NOT_SET",
                    "techc": {
                        "id": 23252437
                    },
                    "zonec": {
                        "id": 23252437
                    },
                    "adminc": {
                        "id": 23252437
                    },
                    "ownerc": {
                        "id": 23252437
                    },
                    "action": "AUTOUPDATE_DNS",
                    "autoRenewStatus": "TRUE"
                }
            }
        }
    ]
}

PUSH notification examples

{
  "id": 1005491844,
  "notify": {
    "type": "autoupdate_dns_success"
  },
  "stid": "20210512-app3-dev-10965",
  "object": {
    "type": "Domain",
    "value": "example.aq",
    "data": {
      "created": "2021-05-12T14:58:01.000+0200",
      "owner": {
        "context": 4,
        "user": "normal_user"
      },
      "updater": {
        "context": 1,
        "user": "support"
      },
      "name": "example.aq",
      "registryStatus": "ACTIVE",
      "nameServers": [
        {
          "name": "ns1.examplenameserver.com"
        },
        {
          "name": "ns2.examplenameserver.com"
        }
      ],
      "period": {
        "unit": "YEAR",
        "period": 1
      },
      "registrarStatus": "ACTIVE",
      "rddsOptIn": "NOT_SET",
      "adminc": {
        "id": 23252437
      },
      "ownerc": {
        "id": 23252437
      },
      "techc": {
        "id": 23252437
      },
      "zonec": {
        "id": 23252437
      },
      "action": "AUTOUPDATE_DNS",
      "autoRenewStatus": "TRUE"
    }
  }
}

autoupdate_dns_error

Description

This notification is sent upon successful execution of an automatic update. An automatic update is performed only if the connectivity check, which is a part of the registration process, has failed.

Only for .de domains.

Notification trigger

This notification is sent directly after a registration or transfer if the DNS check ("NAST check") of DENIC (.de) fails.

This notification is triggered in case of a transfer where name servers have an incorrectly configured zone or no zone for the domain. A general inaccessibility of the name servers also triggers this notification.


Recipient of the notification

The recipient of the notification is the AutoDNS user who started the job.

POLLING notification examples

{
    "stid": "20220121-app3-dev-68409",
    "status": {
        "code": "S0905",
        "text": "The notification was polled successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Message",
        "value": "1012057723",
        "summary": 1
    },
    "data": [
        {
            "id": 1012057723,
            "notify": {
                "type": "autoupdate_dns_error"
            },
            "stid": "20220121-app2-dev-131365",
            "notice": "53300102912\n53300102912\n53300102912\nNameserver error\n      ERROR: 904 Port unreachable\n53300102912\nNameserver error\n      ERROR: 902 Timeout (target, entity, rtype) (ns1.broken-nameserver.com./64.190.62.111:53, example.de, SoaRecord)\n13000000011\n",
            "object": {
                "type": "Domain",
                "value": "example.de",
                "data": {
                    "created": "2022-01-21T14:32:18.000+0100",
                    "owner": {
                        "context": 4,
                        "user": "customer"
                    },
                    "updater": {
                        "context": 1,
                        "user": "support"
                    },
                    "name": "example.de",
                    "registryStatus": "ACTIVE",
                    "nameServers": [
                        {
                            "name": "ns1.broken-nameserver.com"
                        },
                        {
                            "name": "ns2.broken-nameserver.com"
                        }
                    ],
                    "period": {
                        "unit": "YEAR",
                        "period": 1
                    },
                    "registrarStatus": "ACTIVE",
                    "rddsOptIn": "NOT_SET",
                    "ownerc": {
                        "id": 21642636
                    },
                    "adminc": {
                        "id": 21642636
                    },
                    "techc": {
                        "id": 21642636
                    },
                    "zonec": {
                        "id": 21642636
                    },
                    "action": "AUTOUPDATE_DNS",
                    "autoRenewStatus": "TRUE"
                }
            }
        }
    ]
}

PUSH notification examples

{
  "id": 1012057877,
  "notify": {
    "type": "autoupdate_dns_error"
  },
  "stid": "20220121-app2-dev-136539",
  "notice": "53300102912 53300102912 53300102912 Name server error ERROR: 901 Unexpected RCODE (target, entity, RCODE) (/127.0.0.1:53, ns1.nameserver-broken.com, NXDOMAIN) 13000000011 ",
  "object": {
    "type": "Domain",
    "value": "example.de",
    "data": {
      "created": "2022-01-21T15:12:33.000+0100",
      "owner": {
        "context": 4,
        "user": "customer"
      },
      "updater": {
        "context": 1,
        "user": "support"
      },
      "name": "example.de",
      "registryStatus": "ACTIVE",
      "nameServers": [
        {
          "name": "ns1.nameserver-broken.com"
        },
        {
          "name": "ns2.nameserver-broken.com"
        }
      ],
      "period": {
        "unit": "YEAR",
        "period": 1
      },
      "registrarStatus": "ACTIVE",
      "rddsOptIn": "NOT_SET",
      "adminc": {
        "id": 21642636
      },
      "ownerc": {
        "id": 21642636
      },
      "techc": {
        "id": 21642636
      },
      "zonec": {
        "id": 21642636
      },
      "action": "AUTOUPDATE_DNS",
      "autoRenewStatus": "TRUE"
    }
  }
}

autoupdate_deferred_success

Concerns TLDs with manual processing.

Description

This notification is sent in the context of a successful subsequent AutoUpdate.

Notification trigger

The process consists of 2 steps:
Step 1 is indicated by the status code MSG01086 ("The domain action was successfully processed. However, there is still a need to update the domain data..").
Step 2 is acknowledged with the autoupdate_deferred_success notification type and thus completes the manual operation.

Recipient of the notification

The recipient of the notification is the AutoDNS user who started the job.

POLLING notification examples

{
  "stid": "20210507-app3-dev-10535",
  "status": {
    "code": "S0905",
    "text": "The notification was polled successfully.",
    "type": "SUCCESS"
  },
  "object": {
    "type": "Message",
    "value": "1005373215",
    "summary": 1
  },
  "data": [
    {
      "id": 1005373215,
      "notify": {
        "type": "autoupdate_deferred_success"
      },
      "stid": "20210507-app2-dev-19111",
      "object": {
        "type": "Domain",
        "value": "example.aq",
        "data": {
          "created": "2021-05-07T14:52:54.000+0200",
          "owner": {
            "context": 4,
            "user": "normal_user"
          },
          "updater": {
            "context": 4,
            "user": "normal_user"
          },
          "name": "example.aq",
          "registryStatus": "ACTIVE",
          "nameServers": [
            {
              "name": "ns1.examplenameserver.com"
            },
            {
              "name": "ns2.examplenameserver.com"
            }
          ],
          "period": {
            "unit": "YEAR",
            "period": 1
          },
          "registrarStatus": "ACTIVE",
          "rddsOptIn": "NOT_SET",
          "techc": {
            "id": 23252437
          },
          "zonec": {
            "id": 23252437
          },
          "ownerc": {
            "id": 23252437
          },
          "adminc": {
            "id": 23252437
          },
          "action": "AUTOUPDATE_DEFERRED",
          "autoRenewStatus": "TRUE"
        }
      }
    }
  ]
}

PUSH notification examples

{
  "id": 1005453071,
  "notify": {
    "type": "autoupdate_deferred_success"
  },
  "stid": "20210511-app3-dev-7540",
  "object": {
    "type": "Domain",
    "value": "example.aq",
    "data": {
      "created": "2021-05-11T11:17:15.000+0200",
      "owner": {
        "context": 4,
        "user": "normal_user"
      },
      "updater": {
        "context": 4,
        "user": "normal_user"
      },
      "name": "example.aq",
      "registryStatus": "ACTIVE",
      "nameServers": [
        {
          "name": "ns1.examplenameserver.com"
        },
        {
          "name": "ns2.examplenameserver.com"
        }
      ],
      "period": {
        "unit": "YEAR",
        "period": 1
      },
      "registrarStatus": "ACTIVE",
      "rddsOptIn": "NOT_SET",
      "adminc": {
        "id": 23252437
      },
      "ownerc": {
        "id": 23252437
      },
      "zonec": {
        "id": 23252437
      },
      "techc": {
        "id": 23252437
      },
      "action": "AUTOUPDATE_DEFERRED",
      "autoRenewStatus": "TRUE"
    }
  }
}

autoupdate_deferred_error

Description

This notification is sent in the context of a failed downstream AutoUpdate.

Concerns TLDs with manual processing.

Notification trigger

Step 1 is displayed with the status code MSG01086 (" The domain action was successfully processed. However, there is still a need to update the domain data.").

Step 2 is acknowledged with notification type autoupdate_deferred_error and thus completes the manual operation.

Recipient of the notification

The recipient of the notification is the AutoDNS user who started the job.

POLLING notification examples

{
  "stid": "20210507-app3-dev-10868",
  "status": {
    "code": "S0905",
    "text": "The notification was polled successfully.",
    "type": "SUCCESS"
  },
  "object": {
    "type": "Message",
    "value": "1005373399",
    "summary": 1
  },
  "data": [
    {
      "id": 1005373399,
      "notify": {
        "type": "autoupdate_deferred_error"
      },
      "stid": "20210507-app2-dev-19938",
      "object": {
        "type": "Domain",
        "value": "example.aq",
        "data": {
          "created": "2021-05-07T15:38:31.000+0200",
          "owner": {
            "context": 4,
            "user": "normal_user"
          },
          "updater": {
            "context": 4,
            "user": "normal_user"
          },
          "name": "example.aq",
          "registryStatus": "ACTIVE",
          "nameServers": [
            {
              "name": "ns1.examplenameserver.com"
            },
            {
              "name": "ns2.examplenameserver.com"
            }
          ],
          "period": {
            "unit": "YEAR",
            "period": 1
          },
          "registrarStatus": "ACTIVE",
          "rddsOptIn": "NOT_SET",
          "adminc": {
            "id": 23252437
          },
          "techc": {
            "id": 23252437
          },
          "zonec": {
            "id": 23252437
          },
          "ownerc": {
            "id": 23252437
          },
          "action": "AUTOUPDATE_DEFERRED",
          "autoRenewStatus": "TRUE"
        }
      }
    }
  ]
}

PUSH notification examples

{
  "id": 1005453335,
  "notify": {
    "type": "autoupdate_deferred_error"
  },
  "stid": "20210511-app3-dev-7828",
  "object": {
    "type": "Domain",
    "value": "example.aq",
    "data": {
      "created": "2021-05-11T11:31:14.000+0200",
      "owner": {
        "context": 4,
        "user": "normal_user"
      },
      "updater": {
        "context": 4,
        "user": "normal_user"
      },
      "name": "example.aq",
      "registryStatus": "ACTIVE",
      "nameServers": [
        {
          "name": "ns1.examplenameserver.com"
        },
        {
          "name": "ns2.examplenameserver.com"
        }
      ],
      "period": {
        "unit": "YEAR",
        "period": 1
      },
      "registrarStatus": "ACTIVE",
      "rddsOptIn": "NOT_SET",
      "adminc": {
        "id": 23252437
      },
      "ownerc": {
        "id": 23252437
      },
      "zonec": {
        "id": 23252437
      },
      "techc": {
        "id": 23252437
      },
      "action": "AUTOUPDATE_DEFERRED",
      "autoRenewStatus": "TRUE"
    }
  }
}

Frequently used

↗ TLD knowledge base ↗ Policies & troubleshooting ↗ Domains ↗ TLS/SSL & S/MIME ↗ Server & Cloud