Quickstart

Prerequisites

A Gorillaa Mail account (sign up)
An API key (create one from Dashboard → API Keys)

Step 1: Get your API key

Navigate to the API Keys page in your dashboard and create a new key with the email:send scope. Your key will look like:

grl_live_0GyUBWMr1aFAkZdIh1l4nuj4Az6dBDmk...

Store your API key securely. It is shown only once at creation time and cannot be retrieved later.

Step 2: Send your first email

cURL
Node.js
Python

curl -X POST https://api.mail.gorillaa.one/v1/emails \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": [{ "email": "[email protected]" }],
    "subject": "Hello from Gorillaa!",
    "html": "<h1>It works!</h1>"
  }'

const response = await fetch("https://api.mail.gorillaa.one/v1/emails", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    from: "[email protected]",
    to: [{ email: "[email protected]" }],
    subject: "Hello from Gorillaa!",
    html: "<h1>It works!</h1>",
  }),
});

const data = await response.json();
console.log(data);
// { data: { id: "em_abc123", status: "queued" } }

import requests

response = requests.post(
    "https://api.mail.gorillaa.one/v1/emails",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "from": "[email protected]",
        "to": [{"email": "[email protected]"}],
        "subject": "Hello from Gorillaa!",
        "html": "<h1>It works!</h1>",
    },
)

print(response.json())
# {"data": {"id": "em_abc123", "status": "queued"}}

Step 3: Check the response

A successful request returns 202 Accepted:

{
  "data": {
    "id": "em_abc123",
    "status": "queued"
  }
}

The email is now queued for delivery. You can check its status at any time:

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

Step 4: Verify your domain (recommended)

Sending from your own domain improves deliverability. Add and verify a domain:

# 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" }'

The response includes DNS records you need to configure. See the Domain Setup Guide for the full walkthrough.

What’s next?

Sending Emails

Learn about batch send, scheduling, attachments, and idempotency.

SMTP Integration

Send via standard SMTP instead of the REST API. Works with any language or framework.

Domain Setup

Configure DNS records for SPF, DKIM, and DMARC authentication.

Track Events

Monitor delivery, opens, clicks, bounces, and complaints.

Error Handling

Understand error codes and how to handle them.

Get Started

Guides

Reference

Prerequisites

Step 1: Get your API key

Step 2: Send your first email

Step 3: Check the response

Step 4: Verify your domain (recommended)

What’s next?

Sending Emails

SMTP Integration

Domain Setup

Track Events

Error Handling

​Prerequisites

​Step 1: Get your API key

​Step 2: Send your first email

​Step 3: Check the response

​Step 4: Verify your domain (recommended)

​What’s next?

Sending Emails

SMTP Integration

Domain Setup

Track Events

Error Handling

Prerequisites

Step 1: Get your API key

Step 2: Send your first email

Step 3: Check the response

Step 4: Verify your domain (recommended)

What’s next?