🛡️ 1. DNS & Domain Verification API
Grapphen Mail automates 100% deliverability by performing real-time DNS queries against authoritative name servers for your sending domains.
POST
/api/v1/domains/{id}/verify
Auth: Bearer
Queries SPF, DKIM 2048-bit RSA key, DMARC p=reject/quarantine record, and verified BIMI SVG logo location.
Response (JSON)
{
"domain": "enterprise.com",
"spf_verified": true,
"dkim_verified": true,
"dmarc_verified": true,
"bimi_verified": true,
"mta_sts_verified": true,
"deliverability_score": 99.8
}✉️ 2. Outbound Message Dispatch API
Send transactional notifications or multi-channel recruitment outreach with automatic open and click tracking headers.
POST
/api/v1/emails/send
High-Speed Send
| Field | Type | Description |
|---|---|---|
| to | Array / String | Recipient email address(es). |
| subject | String | Subject line (supports UTF-8 encoding). |
| html_body | String | HTML template body. |
| mailbox_id | Integer | Originating authenticated sending mailbox. |
📈 3. Reputation & Automated Warmup Curves
Monitor your domain's real-time sender reputation score across Google Workspace, Microsoft 365, Yahoo, and major ISPs.
GET
/api/v1/admin/reputation
Domain Health
Returns hourly bounce rates, spam complaint rates (<0.01% target), and warmup ramp milestones.
⚡ 4. SES & DMARC Report Ingestion Webhooks
Receive asynchronous delivery, bounce, and complaint telemetry from underlying Postfix and Amazon SES relays.
POST
/api/v1/webhooks/ses
SNS / SES Receiver
Processes Delivery, Bounce, Complaint, and Send events, automatically suppressing hard bounces to protect domain reputation.
💻 5. Code Samples & SDK Quickstart
Send an email using cURL or Python:
curl -X POST "https://mail.grapphen.com/api/v1/emails/send" \
-H "Authorization: Bearer YOUR_SANCTUM_TOKEN" \
-H "Content-Type: application/json" \
-d '{"to": "[email protected]", "subject": "Welcome to Grapphen Ecosystem", "html_body": "Welcome
"}'