API Documents
Documentation API Documents Update the Dynamic DNS Record

Update the Dynamic DNS Record

1. API Description

This API (Record.Ddns) is used to update the dynamic DNS rcord.
Domain name for API request:https://api.dnspod.com/Record.Ddns
HTTP request method: POST

2. Request Parameters

The table below lists only the API request parameters. Common request parameters are required when the API is called. For more information, please see Common Request Parameters.

Parameter Required Description
domain_id yes The domain id. Mandatory parameter.
record_id yes The record id. Mandatory parameter.
sub_domain no The record name like “www”.
record_line yes The record line.You can get the list from the API.The default value is “default”, such as “default”, “AD”, “AE”. Mandatory parameter.
value yes The IP address like “”.Optional parameter.

3. Response Codes

Only the response codes related to this API are listed below. For other response codes, please see Common Return Codes.

Response Code Description
-15 Domain got prohibited.
-7 A domain of a company account need a upgrade first.
-8 You need a upgrade for the domain you are acting for.
6 Invalid domain id.。
7 You don’t have the permission.
8 Invalid record id.
21 Domain got locked.
22 Invalid sub domain.
23 The number of the record level is up to limit.
24 Invalid sub domain for general analysis.。
25 The number of poll is up to limit.
26 Invalid record line.

4. Sample

curl -X POST https://api.dnspod.com/Record.Ddns -d 'login_token=730060,e1a8a$f14dc5dcbafd83680b3d2a553c4d553d&format=json&domain_id=2317346&record_id=16894439&record_line=default&sub_domain=www'

The following is a sample response:

  • JSON:
    "status": {
        "message":"Action completed successful",
        "created_at":"2012-11-24 17:23:58"
    "record": {
Last updated on 2022-03-11 02:59

DNSPod 域名检测工具


Official WeChat group

Join WeChat group to chat and feedback

Scan using WeChat