SPOG.AI integrates with GoDaddy to centralize active-domain inventory and lifecycle visibility. The implemented connector imports domain registration, expiry, renewal, lock, privacy, WHOIS-exposure, and nameserver metadata into the SPOG.AI CMDB.
Key Features
| Capability | Description |
|---|---|
| Domain Inventory | Imports active domains accessible to the configured GoDaddy customer account. |
| Lifecycle Visibility | Collects expiration dates and automatic-renewal status. |
| Protection Status | Tracks domain lock, transfer protection, and privacy attributes. |
| Registration Context | Includes WHOIS-exposure and nameserver metadata returned by GoDaddy. |
| CMDB Enrichment | Normalizes domain records and removes stale GoDaddy enrichment after a successful synchronization. |
How the Integration Works
The SPOG Appliance calls the GoDaddy Domains API over HTTPS using an API key and secret in the sso-key authorization header. It supplies the configured customer ID, requests active domains with nameserver data, follows pagination markers, normalizes the returned lifecycle and protection attributes, and enriches domain records in SPOG.AI.
Prerequisites
Before configuring the integration, ensure the following prerequisites are met:
- Tenant Admin authorization in SPOG.AI and permission to create integrations.
- A GoDaddy account eligible to use the required production or OTE API environment.
- A GoDaddy API key, API secret, and customer or shopper ID.
- The domains to be inventoried must be accessible to the configured GoDaddy customer account.
- Outbound HTTPS access from the SPOG Appliance to the selected GoDaddy API endpoint.
Configuration
1. Create GoDaddy API Credentials
Create a dedicated API key in the GoDaddy Developer Portal.
- Open My Apps or API Keys and create a new key.
- Select Production for live domains or OTE for test data.
- Copy the API key and secret immediately, then store them securely.
2. Record the Customer ID
Identify the account context used by the Domains API.
- Record the GoDaddy customer or shopper ID associated with the domains.
- Confirm the API credential can read the required active domains.
3. Configure and Link the Integration
Add the GoDaddy integration in SPOG.AI.
- Enter the API host, API key, API secret, and customer ID.
- Run Test Connection, save the integration, and link it to the required appliance.
Configuration Fields
Use the fields below when creating the integration in SPOG.AI.
| Field | Requirement | Description |
|---|---|---|
| host | Mandatory | GoDaddy API base URL, such as https://api.godaddy.com or the approved OTE endpoint. |
| api_key | Mandatory | API key created in the GoDaddy Developer Portal. |
| api_secret | Mandatory | Secret paired with the API key; copy it when generated. |
| customer_id | Mandatory | GoDaddy customer or shopper identifier supplied to the Domains API. |
Security and Connectivity
- Use a dedicated, least-privileged credential for read-only domain inventory.
- Store the key and secret in a secrets vault, rotate them periodically, and revoke them immediately if compromised.
- Allow outbound HTTPS port 443 to the configured GoDaddy endpoint and require TLS 1.2 or later.
- Plan for GoDaddy rate limits and account eligibility restrictions.
- Note: the current connector disables certificate verification internally and logs credential values; remediate both issues before production deployment.
Validation and Data Coverage
Run Test Connection or start a synchronization, then confirm active GoDaddy domains appear in SPOG.AI with expiry, renewal, protection, privacy, WHOIS-exposure, and nameserver data. A 401 indicates invalid credentials, a 403 indicates insufficient access, ACCESS_DENIED can indicate account eligibility restrictions, and timeouts usually indicate DNS, proxy, or firewall issues.
| Data | Coverage |
|---|---|
| Domains | Active domains returned by the GoDaddy /v1/domains endpoint. |
| Lifecycle | Expiration timestamp and automatic-renewal status. |
| Protection | Lock, transfer-protection, privacy, and WHOIS-exposure attributes. |
| Nameservers | Nameserver details included in the domain response. |
| Not Implemented | DNS record ingestion, SSL certificate collection, account-profile ingestion, write operations, and webhook processing are not performed by the current connector. |
Uninstalling the Integration
- Delete the GoDaddy integration in SPOG.AI and unlink it from the appliance.
- Revoke or delete the GoDaddy API key and secret when they are no longer required.
- Remove obsolete firewall, proxy, or allowlist rules.