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 -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"
}
}
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" }'
What’s next?
