Documentation
OgBae provides email delivery through a REST API and SMTP relay. This guide covers setup and usage.
Overview
OgBae is a credit-based email platform. You purchase credits upfront and each email deducts credits: 1 credit for transactional emails, 2 credits for marketing emails. There are no monthly subscriptions or minimums.
The platform has two APIs hosted on separate domains:
email-api.ogbae.com— Email sending endpoint. Used with API keys.panel-api.ogbae.com— Account management (domains, credentials, logs, webhooks, suppressions, billing). Used with session cookies.
Quickstart
- Create an account at panel.ogbae.com.
- Add a domain in the dashboard and configure the DNS records (SPF, DKIM, return-path).
- Create an API key in the API Keys section of the dashboard.
- Purchase credits in the Billing section.
- Send your first email using the API:
curl -X POST https://email-api.ogbae.com/api/v1/email/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "hello@yourdomain.com",
"to": ["user@example.com"],
"subject": "Hello from OgBae",
"html": "<h1>It works!</h1>",
"type": "transactional"
}'SMTP Relay
You can also send email via SMTP. Create SMTP credentials in the dashboard, each scoped to transactional or marketing.
| Host | mail.ogbae.com |
| Port | 587 |
| Encryption | STARTTLS |
| Authentication | PLAIN |
Use the SMTP username and password from the dashboard as your credentials. The credential type (transactional or marketing) determines which relay pool your email is routed through.
SMTP Tracking Override
When sending via SMTP, you can control open and click tracking per-email using custom headers. These headers are stripped from the outbound message and never reach the recipient.
| X-Ogbae-Track-Opens | true or false |
| X-Ogbae-Track-Clicks | true or false |
If omitted, tracking defaults are used based on the credential type: marketing credentials enable tracking by default, transactional credentials disable it by default.