Domain Setup

Overview

To send emails from your own domain (e.g. [email protected]), you need to:

Add the domain via the API
Configure 4 DNS records at your DNS provider
Verify the domain

Once verified, your domain is authenticated with SPF, DKIM, and DMARC — which significantly improves deliverability and prevents spoofing.

Step 1: Add a domain

curl -X POST https://api.mail.gorillaa.one/v1/domains \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "yourdomain.com" }'

Response

{
  "data": {
    "id": "dom_abc123",
    "domain": "yourdomain.com",
    "subdomain": null,
    "verification_status": "pending",
    "verified_at": null,
    "dkim_selector": "gorillaa",
    "dkim_status": null,
    "warming_status": "not_started",
    "warming_current_limit": null,
    "reputation_score": null,
    "is_default": false,
    "records": [
      {
        "type": "TXT",
        "host": "_gorillaa-verify.yourdomain.com",
        "value": "gorillaa-verify=a1b2c3d4e5f6...",
        "priority": null,
        "purpose": "verification",
        "verified": false
      },
      {
        "type": "CNAME",
        "host": "gorillaa._domainkey.yourdomain.com",
        "value": "gorillaa._domainkey.yourdomain.com.mail.gorillaa.one",
        "priority": null,
        "purpose": "dkim",
        "verified": false
      },
      {
        "type": "TXT",
        "host": "yourdomain.com",
        "value": "v=spf1 include:_spf.mail.gorillaa.one ~all",
        "priority": null,
        "purpose": "spf",
        "verified": false
      },
      {
        "type": "TXT",
        "host": "_dmarc.yourdomain.com",
        "value": "v=DMARC1; p=none; rua=mailto:[email protected]",
        "priority": null,
        "purpose": "dmarc",
        "verified": false
      }
    ],
    "created_at": "2026-02-09T12:00:00Z",
    "updated_at": "2026-02-09T12:00:00Z"
  }
}

Step 2: Configure DNS records

Add these 4 records at your DNS provider (e.g. Cloudflare, Route 53, GoDaddy):

#	Type	Host / Name	Value	Purpose
1	TXT	`_gorillaa-verify.yourdomain.com`	`gorillaa-verify=a1b2c3...`	Domain ownership verification
2	CNAME	`gorillaa._domainkey.yourdomain.com`	`gorillaa._domainkey.yourdomain.com.mail.gorillaa.one`	DKIM signing
3	TXT	`yourdomain.com`	`v=spf1 include:_spf.mail.gorillaa.one ~all`	SPF authorization
4	TXT	`_dmarc.yourdomain.com`	`v=DMARC1; p=none; rua=mailto:...`	DMARC policy

SPF: If you already have an SPF record, add include:_spf.mail.gorillaa.one to your existing record instead of creating a new one. Only one SPF record is allowed per domain.

DNS provider examples

Cloudflare: Go to DNS → Add Record. Set type, name, and content. Proxy must be off (DNS only) for CNAME records.Route 53: Go to Hosted Zones → your domain → Create Record. Use “Simple routing” for each record.GoDaddy: Go to My Products → DNS → Add Record. For the host field, use just the subdomain part (e.g. _gorillaa-verify instead of the full hostname).

Step 3: Verify the domain

After configuring DNS records (allow up to 48 hours for propagation), trigger verification:

curl -X POST https://api.mail.gorillaa.one/v1/domains/dom_abc123/verify \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": {
    "success": true,
    "status": "verified",
    "domain_verified": true,
    "dkim_verified": true,
    "errors": []
  }
}

If verification fails, success will be false and the errors array will describe which checks failed:

{
  "data": {
    "success": false,
    "status": "pending",
    "domain_verified": false,
    "dkim_verified": false,
    "errors": [
      "TXT verification record not found",
      "DKIM CNAME record not found"
    ]
  }
}

Verification requires the TXT record (_gorillaa-verify). DKIM is checked separately via its CNAME record. We strongly recommend configuring all four DNS records for best deliverability.

Domain warming

New domains start with limited daily sending capacity that gradually increases:

Day	Daily limit
1	20
2	40
3	80
4	160
5	320
6	640
7	1,280
14	2,560
21	5,120
28	10,000
35+	Unlimited

The warming status is visible in the domain response (warming_status field):

Status	Meaning
`not_started`	Domain verified but no emails sent yet
`warming`	Active warming — limits are gradually increasing
`warmed`	Domain is fully warmed, no volume restrictions
`paused`	Warming paused due to high bounce/complaint rate

If your bounce rate exceeds thresholds during warming, the process is automatically paused to protect your sender reputation. Investigate bounces before resuming.

DKIM key rotation

Rotate your DKIM signing keys without changing any DNS records:

curl -X POST https://api.mail.gorillaa.one/v1/domains/dom_abc123/rotate-dkim \
  -H "Authorization: Bearer YOUR_API_KEY"

Because DKIM is configured via a CNAME record pointing to Gorillaa’s infrastructure, we update the signing key on our side. No DNS changes needed. The old key remains valid for 48 hours to handle DNS propagation.

Set default domain

Make a domain the default sender for your organization:

curl -X POST https://api.mail.gorillaa.one/v1/domains/dom_abc123/set-default \
  -H "Authorization: Bearer YOUR_API_KEY"

List & delete domains

List all domains

curl https://api.mail.gorillaa.one/v1/domains \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "data": [ /* array of domain objects */ ],
  "total": 3
}

Delete a domain

curl -X DELETE https://api.mail.gorillaa.one/v1/domains/dom_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "success": true
}

Deleting a domain removes all associated DNS configurations. Emails already queued for this domain will still attempt delivery.

Get Started

Guides

Reference

Overview

Step 1: Add a domain

Response

Step 2: Configure DNS records

Step 3: Verify the domain

Response

Domain warming

DKIM key rotation

Set default domain

List & delete domains

List all domains

Delete a domain

​Overview

​Step 1: Add a domain

​Response

​Step 2: Configure DNS records

​Step 3: Verify the domain

​Response

​Domain warming

​DKIM key rotation

​Set default domain

​List & delete domains

​List all domains

​Delete a domain

Overview

Step 1: Add a domain

Response

Step 2: Configure DNS records

Step 3: Verify the domain

Response

Domain warming

DKIM key rotation

Set default domain

List & delete domains

List all domains

Delete a domain