Add domain

Add a new custom domain

Start the domain setup process. This creates the necessary infrastructure and returns the nameservers you need to configure at your domain registrar.

Setup Process

1. Add Domain (this endpoint) - Creates infrastructure
2. Configure Nameservers - Update your domain’s nameservers at your registrar
3. Activate Domain - Complete the setup

Example Usage

import requests

response = requests.post(
    "https://api.coldsend.io/api/public/v1/domains",
    headers={"X-API-Key": "your-api-key"},
    json={
        "domain": "mail.yourcompany.com"
    }
)

print(response.json())
# Returns nameservers to configure