> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modulex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# GoDaddy Integration for AI Agents & Workflows

> Domain registration, availability checking, and management via the GoDaddy API

{/* Self-hosted logo — build-time vendored from modulex.json / Iconify (see scripts/lib/logo.js). */}

<img className="block dark:hidden" src="https://mintcdn.com/modulexaillc/zKB2qsP6Q61VNLfB/logos/godaddy-light.svg?fit=max&auto=format&n=zKB2qsP6Q61VNLfB&q=85&s=e913e8a9c54693b987ca48cc461c60a8" alt="GoDaddy logo" width="72" height="72" data-path="logos/godaddy-light.svg" />

<img className="hidden dark:block" src="https://mintcdn.com/modulexaillc/zKB2qsP6Q61VNLfB/logos/godaddy-dark.svg?fit=max&auto=format&n=zKB2qsP6Q61VNLfB&q=85&s=d5eb11a52c3ed337b2590d06977fd7b1" alt="GoDaddy logo" width="72" height="72" data-path="logos/godaddy-dark.svg" />

## Overview

Add **GoDaddy** to any ModuleX agent or workflow. Domain registration, availability checking, and management via the GoDaddy REST API (`api.godaddy.com/v1`).

<Info>
  **Categories**: Cloud Infrastructure · Domains · Infrastructure · Web Hosting · **Auth**: GoDaddy API Key + Secret · **Actions**: 5
</Info>

## Authentication

### GoDaddy API Key + Secret

Authenticate using a GoDaddy API key and secret pair. The Authorization header is built as 'sso-key \<key>:\<secret>'.

#### Required Credentials

| Field      | Description                                                                                                                                                                        | Required | Format                     |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------------------------- |
| API Key    | Your GoDaddy API Key from developer.godaddy.com                                                                                                                                    | Yes      | `xxxxxxxxxxxxxxxx`         |
| API Secret | Your GoDaddy API Secret from developer.godaddy.com                                                                                                                                 | Yes      | `xxxxxxxxxxxxxxxxxxxxxxxx` |
| API URL    | GoDaddy API base URL. Use [https://api.godaddy.com](https://api.godaddy.com) for production or [https://api.ote-godaddy.com](https://api.ote-godaddy.com) for the test environment | Yes      | `https://api.godaddy.com`  |

## Available Actions

<AccordionGroup>
  <Accordion title="check_domain_availability — Check the availability of a domain for purchase or transfer">
    ### Parameters

    <ResponseField name="domain" type="string" required>
      The domain name to check availability for (e.g. example.com)
    </ResponseField>

    <ResponseField name="check_type" type="string">
      Optimize for time (FAST) or accuracy (FULL). Allowed values: FAST, FULL
    </ResponseField>

    <ResponseField name="for_transfer" type="boolean">
      Whether to include domains available for transfer. If true, check\_type is ignored
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "available": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Available"
        },
        "domain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Domain"
        },
        "definitive": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Definitive"
        },
        "price": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Price"
        },
        "currency": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Currency"
        },
        "period": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Period"
        }
      },
      "required": [
        "success"
      ],
      "title": "CheckDomainAvailabilityOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="list_domains — List domains owned by the authenticated GoDaddy account">
    ### Parameters

    <ResponseField name="statuses" type="array">
      Filter by status. Array of strings: ACTIVE, CANCELLED, etc.
    </ResponseField>

    <ResponseField name="status_groups" type="array">
      Filter by status group. Array of strings: VISIBLE, INACTIVE, RENEWABLE, etc.
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Maximum number of domains to return
    </ResponseField>

    <ResponseField name="marker" type="string">
      Marker domain to use as the offset in results
    </ResponseField>

    <ResponseField name="includes" type="array">
      Optional details to include: authCode, contacts, nameServers
    </ResponseField>

    <ResponseField name="modified_date" type="string">
      Only include results modified since this date (ISO 8601 format)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "DomainSummary": {
          "additionalProperties": false,
          "description": "A domain summary object from the list domains endpoint.",
          "properties": {
            "domain": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Domain"
            },
            "status": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Status"
            },
            "expires": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Expires"
            },
            "created_at": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Created At"
            },
            "renewable": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Renewable"
            }
          },
          "title": "DomainSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "domains": {
          "items": {
            "$ref": "#/$defs/DomainSummary"
          },
          "title": "Domains",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "ListDomainsOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="list_tlds_options — Retrieve the list of available top-level domains (TLDs)">
    ### Response

    ```json theme={null}
    {
      "$defs": {
        "TldInfo": {
          "additionalProperties": false,
          "description": "A TLD entry from the list TLDs endpoint.",
          "properties": {
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Type"
            }
          },
          "title": "TldInfo",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "tlds": {
          "items": {
            "$ref": "#/$defs/TldInfo"
          },
          "title": "Tlds",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "ListTldsOptionsOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="renew_domain — Renew a domain registration in GoDaddy">
    ### Parameters

    <ResponseField name="domain" type="string" required>
      The domain name to renew (e.g. example.com)
    </ResponseField>

    <ResponseField name="period" type="integer">
      Number of years to extend the domain (1-10). Defaults to original purchase period when omitted
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "order_id": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Order Id"
        },
        "item_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Item Count"
        },
        "total": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Total"
        },
        "currency": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Currency"
        }
      },
      "required": [
        "success"
      ],
      "title": "RenewDomainOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="suggest_domains — Suggest available domain names based on given criteria">
    ### Parameters

    <ResponseField name="query" type="string" required>
      Domain name or keywords for which alternative domain names will be suggested
    </ResponseField>

    <ResponseField name="country" type="string">
      Two-letter ISO country code as a hint for target region
    </ResponseField>

    <ResponseField name="city" type="string">
      City name as a hint for target region
    </ResponseField>

    <ResponseField name="sources" type="array">
      Sources to query: CC\_TLD, EXTENSION, KEYWORD\_SPIN, PREMIUM
    </ResponseField>

    <ResponseField name="tlds" type="array">
      Top-level domains to include in suggestions (e.g. com, net, org)
    </ResponseField>

    <ResponseField name="length_max" type="integer">
      Maximum length of second-level domain
    </ResponseField>

    <ResponseField name="length_min" type="integer">
      Minimum length of second-level domain
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Maximum number of suggestions to return
    </ResponseField>

    <ResponseField name="wait_ms" type="integer">
      Maximum time in milliseconds to wait for responses
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "suggestions": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Suggestions",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "SuggestDomainsOutput",
      "type": "object"
    }
    ```
  </Accordion>
</AccordionGroup>

## Limits & Quotas

* **Production API**: 60 requests per minute per API key (per GoDaddy developer documentation).
* **OTE (test) API**: Lower rate limits; intended for development only.
* **Renewal actions** incur actual charges on the account.
* **Error model**: non-2xx responses and timeouts are caught and returned as `success=False` + `error` rather than raising.

## Related integrations

<CardGroup cols={3}>
  <Card title="Amazon Web Services" href="/integrations/tools/aws" />

  <Card title="Azure Storage" href="/integrations/tools/azure-storage" />

  <Card title="Cloudflare" href="/integrations/tools/cloudflare" />
</CardGroup>

## Links

* [GoDaddy](https://www.godaddy.com)