PieMail
PieMail is a managed email delivery service by PieHost. Send transactional emails, run campaigns, and automate sequences — all from your own domain, without managing mail servers.
Getting Started
Create a PieMail Instance
- Go to Dashboard → Click Launch → Select PieMail
- Give it a name and choose a plan
- Click Create PieMail Cluster
Your instance is ready immediately. From there you can add a custom domain, create SMTP credentials, or grab your API key.
Sending Email
PieMail offers three ways to send:
1. SMTP
Use any SMTP-compatible library, framework, or tool.
| Setting | Value |
|---|---|
| Host | mail.pie.host |
| Port | 587 |
| Security | TLS |
Create an SMTP user under SMTP in the dashboard to get your username and password.
Laravel example:
MAIL_MAILER=smtp
MAIL_HOST=mail.pie.host
MAIL_PORT=587
MAIL_USERNAME=you@yourdomain.com
MAIL_PASSWORD=your_password
MAIL_ENCRYPTION=tls
Node.js (Nodemailer) example:
{
host: 'mail.pie.host',
port: 587,
secure: false,
auth: { user: 'you@yourdomain.com', pass: 'your_password' }
}
2. REST API
Send a single email with one POST request.
Endpoint: POST https://mail.pie.host/api/send
Headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Body:
{
"to": "recipient@example.com",
"from": "you@yourdomain.com",
"subject": "Hello!",
"html": "<p>Hi {{first_name}}, welcome aboard.</p>"
}
Get your API key from Dashboard → API.
3. Campaigns (dashboard)
Send bulk email to a group of contacts — one-time sends or scheduled.
- Add contacts and organize them into groups
- Go to Campaigns → New Campaign
- Set subject, write HTML content, select recipient group
- Send now or schedule for later
Custom Domains
Sending from your own domain (e.g. hello@yourcompany.com) is available on eligible plans.
Setup
- Go to Domains → Add Domain
- Enter your domain (e.g. yourcompany.com)
- Add the verification CNAME to your DNS provider
- PieMail detects the record and verifies ownership
Once verified, PieMail displays all the DNS records you need:
| Type | Host | Value |
|---|---|---|
| MX | @ | mail.pie.host |
| TXT | @ | v=spf1 mx ~all |
| TXT | mail._domainkey | DKIM public key (shown in dashboard) |
Add these records at your DNS provider. PieMail automatically signs all outgoing mail with DKIM and SPF — you don't need to configure anything else.
Contacts & Groups
Contacts
- Each contact has an email address and up to 100 custom attributes (e.g. first_name, company, plan)
- Contacts can be added manually via the dashboard or via API
- Unsubscribed and bounced contacts are automatically suppressed from future sends
Groups
Organize contacts into groups to target specific segments in campaigns and cadences.
Cadences (Automated Sequences)
Cadences are multi-step email sequences that run automatically.
Trigger options:
- Contact is created
- Contact joins a group
Features:
- Set a delay (in days) between each email in the sequence
- Enable Pause on Reply — the cadence stops automatically when a contact replies
- Enroll contacts manually or automatically via trigger
Tracking & Analytics
All emails sent through PieMail include automatic tracking (no extra setup needed):
- Opens — tracked per recipient
- Link clicks — all links in your emails are rewritten to track clicks
- Bounces — tracked per domain; bounced addresses are suppressed
- Unsubscribes — unsubscribe links are automatically included in campaigns and cadences
The dashboard shows a 30-day overview of send volume, bounce rate, and engagement. Campaign and cadence pages show per-send delivery stats.
SMTP Accounts
You can create multiple SMTP users under your domain — for example:
Each SMTP account gets its own username and password. Manage them under SMTP in the dashboard.
Plans
Plans differ by monthly send limit, daily send limit, and contacts limit. All plans include SMTP, REST API, tracking, and analytics.
| Feature | Availability |
|---|---|
| SMTP sending | All plans |
| REST API | All plans |
| Open & click tracking | All plans |
| Custom domain | Eligible plans only |
| Campaigns & cadences | Eligible plans only |
Daily limit: Campaigns are rejected at creation if the recipient count exceeds your plan's daily limit. Upgrade your plan or reduce the recipient group to proceed.
Monthly limit: Sends beyond your monthly quota are charged at a small per-email overage rate rather than blocked (on eligible plans).
Contact limit: Each plan has a maximum contact count. You'll need to upgrade to add more.
Enterprise plans with custom volume are available — See pricing page.
Security
- All SMTP connections use TLS encryption
- REST API requires Bearer token authentication
- All outgoing mail is signed with DKIM and authorized via SPF
- Unsubscribe and bounce suppression is automatic and cannot be disabled
Deleting PieMail
Go to PieMail Settings → Delete. This is permanent and cannot be undone. Export your contacts and campaigns before deleting.
Support
Open a support ticket from your dashboard or visit piehost.com/contact.
