DevOps & CloudDocumentedScanned

godaddy

GoDaddy API for managing DNS records.

Share:

Installation

npx clawhub@latest install godaddy

View the full skill documentation and source below.

Documentation

GoDaddy DNS

Manage DNS records for domains hosted on GoDaddy.

Setup

Get your API credentials from GoDaddy:

  • Go to

  • Create a new API Key (Production)

  • Note down the Key and Secret
  • Store in ~/.clawdbot/clawdbot.json:

    {
      "skills": {
        "entries": {
          "godaddy": {
            "apiKey": "YOUR_API_KEY",
            "apiSecret": "YOUR_API_SECRET"
          }
        }
      }
    }

    Or set env: GODADDY_API_KEY=xxx and GODADDY_API_SECRET=xxx

    Quick Reference

    List Domains

    {baseDir}/scripts/godaddy.sh domains list

    DNS Records

    # List all DNS records for a domain
    {baseDir}/scripts/godaddy.sh dns list <domain>
    
    # List records by type
    {baseDir}/scripts/godaddy.sh dns list <domain> --type A
    {baseDir}/scripts/godaddy.sh dns list <domain> --type CNAME
    {baseDir}/scripts/godaddy.sh dns list <domain> --type TXT
    {baseDir}/scripts/godaddy.sh dns list <domain> --type MX
    
    # Get specific record
    {baseDir}/scripts/godaddy.sh dns get <domain> <type> <name>
    
    # Add a record
    {baseDir}/scripts/godaddy.sh dns add <domain> --type A --name www --data 1.2.3.4 --ttl 3600
    {baseDir}/scripts/godaddy.sh dns add <domain> --type CNAME --name blog --data example.com --ttl 3600
    {baseDir}/scripts/godaddy.sh dns add <domain> --type TXT --name _dmarc --data "v=DMARC1; p=none" --ttl 3600
    
    # Update a record (replaces existing records with same type+name)
    {baseDir}/scripts/godaddy.sh dns update <domain> --type A --name www --data 5.6.7.8 --ttl 3600
    
    # Delete records by type and name
    {baseDir}/scripts/godaddy.sh dns delete <domain> --type A --name www

    Common DNS Record Types

    TypeUsage
    AIPv4 address
    AAAAIPv6 address
    CNAMEAlias to another domain
    MXMail server
    TXTText records (SPF, DKIM, verification)
    NSNameserver
    SRVService records

    Examples

    Add subdomain pointing to IP

    godaddy.sh dns add example.com --type A --name app --data 192.168.1.1 --ttl 600

    Add CNAME for www

    godaddy.sh dns add example.com --type CNAME --name www --data example.com --ttl 3600

    Add TXT for domain verification

    godaddy.sh dns add example.com --type TXT --name @ --data "google-site-verification=xxx" --ttl 3600

    Add MX record

    godaddy.sh dns add example.com --type MX --name @ --data "mail.example.com" --ttl 3600 --priority 10

    Notes

    • API Base: - Auth: Authorization: sso-key {key}:{secret} - The @` symbol represents the root domain
    • TTL is in seconds (minimum 600 for most record types)
    • Rate limits apply - don't spam the API