New Integration: GoDaddy

Description

Add GoDaddy integration to sync domain registrations, DNS records, SSL certificates, and domain management events into CORE.

Reference Implementations

Existing Integrations (use as templates)

• integrations/github/ - Similar API-key authenticated service
• integrations/linear/ - Project management integration
• integrations/slack/ - For reference

Required Files Structure

integrations/godaddy/
├── src/
│   ├── index.ts          # Main entry, API key spec
│   ├── schedule.ts       # Sync logic
│   ├── utils.ts          # GoDaddy API utilities
│   ├── account-create.ts # API key setup
│   └── create-activity.ts # Activity formatting
├── package.json
├── tsup.config.ts
└── README.md

GoDaddy API Integration

Authentication Setup

• Use API Key + Secret authentication (OTE for testing, Production for live)
• Base URLs: https://api.ote-godaddy.com (test), https://api.godaddy.com (production)
• Rate limit: 60 requests per minute per API key
• API keys are generated via the GoDaddy Developer Portal

Key Endpoints

• GET /v1/domains - List all domains in account
• GET /v1/domains/{domain} - Get domain details
• GET /v1/domains/{domain}/records - Get DNS records
• PATCH /v1/domains/{domain}/records - Update DNS records
• GET /v1/domains/{domain}/dns - DNS management
• GET /v1/certificates - List SSL certificates
• GET /v2/customers/{customerId}/domains - Customer domain listing
• POST /v1/domains/purchase - Purchase a domain
• GET /v1/domains/available - Check domain availability

Events to Track

1. Domain Management - Domain registrations, renewals, transfers, expirations
2. DNS Changes - Record additions, modifications, deletions
3. SSL Certificates - Certificate issuance, renewal, expiration warnings
4. Domain Availability - Availability checks and purchase events

Implementation Tasks

• Set up basic integration structure following integrations/github/src/index.ts pattern
• Implement API Key + Secret authentication flow in account-create.ts
• Create API utilities in utils.ts with rate limiting (60 req/min)
• Implement sync logic in schedule.ts for domains, DNS records, and certificates
• Convert domain events to CORE activity format
• Add error handling and rate limiting
• Create integration documentation
• Add to integrations/README.md

Technical Notes

• GoDaddy API uses API Key + Secret passed as Authorization: sso-key {key}:{secret} header
• Rate limited to 60 requests per minute
• OTE (Open Test Environment) available for development testing
• GoDaddy also recently introduced an Agent Name Service (ANS) API for AI agent identity

Resources

• GoDaddy Developer Portal
• GoDaddy API Documentation
• Domains API Docs
• Getting Started Guide

Labels

enhancement, integration, new-feature