godaddy

name	godaddy
description	GoDaddy API for managing DNS records. Use for listing, adding, updating, or deleting DNS records on GoDaddy-managed domains.

GoDaddy DNS

Manage DNS records for domains hosted on GoDaddy.

Setup

Get your API credentials from GoDaddy:

1. Go to https://developer.godaddy.com/keys
2. Create a new API Key (Production)
3. 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

Type	Usage
A	IPv4 address
AAAA	IPv6 address
CNAME	Alias to another domain
MX	Mail server
TXT	Text records (SPF, DKIM, verification)
NS	Nameserver
SRV	Service 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: https://api.godaddy.com
• 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