Knowledge Base

Documentation

Everything you need to run your team's email on Mailcoy.

Quickstart Guide

Set up your entire company's business email on Mailcoy in under 5 minutes by following these 4 straightforward steps:

1

Add & Verify Domain

Navigate to Domains, enter your root domain (e.g. yourcompany.com), and copy the DNS ownership and MX records.

2

Add Employees

Under Employees, assign professional addresses (e.g. sales@yourcompany.com) paired with their Gmail accounts.

3

Connect Gmail Inboxes

Staff scan the 1-click QR code or click the invite link to connect their Gmail inbox in seconds with zero workflow disruption.

4

Signatures & Policies

Configure centralized company email signatures, catch-all routing, and team admin permissions in Settings.

Zero Downtime Migration: You can set up Mailcoy alongside existing email providers with zero lost customer inquiries.

Domains & DNS Authentication

To send and receive emails as @yourcompany.com, add the following DNS authentication records to your domain registrar (Namecheap, GoDaddy, Cloudflare, etc.):

TypeHost / NameValue / TargetPriority / TTLAction
MX@inbound-smtp.us-east-1.amazonaws.com10 / 300s
MX@inbound-smtp.us-east-1.amazonaws.com20 / 300s
TXT@v=spf1 include:amazonses.com ~allAuto
TXT_dmarcv=DMARC1; p=quarantine; rua=mailto:dmarc@mailcoy.comAuto

Once entered in your registrar, click Verify Domain in the dashboard for instant DoH verification.

Employee Inboxes & 1-Click Linking

Assign professional email addresses to your teammates without paying for Google Workspace licenses.

Pending Invite

Invite link dispatched, awaiting Gmail authentication.

Connected

Gmail active, 2-way routing operating under 200ms.

1-Click Offboarding

Immediately revokes sending and reroutes inbox traffic.

Gmail Integration & Send-As Setup

Employees send and receive directly inside standard Gmail using their custom business email address:

Outbound SMTP Configuration:

Server: smtp.resend.com
Port: 465 (SSL)
Username: resend
Password: SMTP API KeyFrom Dashboard
  1. Open Gmail Settings → Accounts and Import.
  2. Under "Send mail as", click "Add another email address".
  3. Enter the employee's name and business email address (keep "Treat as an alias" checked).
  4. Enter the SMTP details above and confirm the 6-digit verification code.
  5. Select "Reply from the same address to which the message was sent".
📱 Mobile Sync (iOS & Android): Once completed in your mobile browser, the custom From: address will automatically sync to the official Gmail app on your smartphone.

Aliases & Department Routing

Create shared department addresses like sales@, support@, or billing@.

Fan-Out Broadcast:

Every incoming customer email is delivered simultaneously to all assigned team members' Gmail inboxes.

Round-Robin Distribution:

Distributes incoming leads sequentially across team members to maintain balanced workload.

Branded Email Signatures

Deploy unified, professional email signatures across all employees with smart merge tags:

Supported Merge Tags:
{name}{title}{email}{phone}{company}{website}{booking_link}

Catch-All Email Routing

Catch emails sent to mistyped or unassigned addresses on your domain (e.g. info@, contact@):

Shared Inbox Mode:

Stores unknown incoming mail quietly in your workspace Email Logs for easy auditing.

Forwarding Mode:

Instantly forwards all catch-all mail to an administrative manager or founder's inbox.

Analytics, Delivery Health & DNSBL

Monitor your domain's sending health, bounce rates, and spam blacklist status across 24-hour, 7-day, 30-day, and 12-month periods.

DNSBL & Reputation Monitoring:

Mailcoy continuously monitors global spam registries (Spamhaus, Barracuda, SORBS) to verify your domain maintains clean IP reputation and zero blacklisting.

Email Delivery Logs

Full message history with instant search, direction badges (Inbound vs Outbound), delivery timestamps, and payload inspection.

Click any row in the dashboard Email Logs to view full message IDs, sender verification headers, and transmission latency.

REST API & Developer Integration

Send automated transactional emails (invoices, receipts, notifications) from your apps or CRM using the Mailcoy REST API.

POST /v1/emails/send
curl -X POST https://api.mailcoy.com/v1/emails/send \
  -H "Authorization: Bearer mc_live_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "sales@yourcompany.com",
    "to": "client@apple.com",
    "subject": "Enterprise Proposal",
    "html": "<p>Proposal attached.</p>"
  }'

Security, Privacy & Encryption

Mailcoy is engineered with strict enterprise privacy protections:

Zero Passwords

We never ask for or store Google account passwords. All tokens use OAuth 2.0.

AES-256 At Rest

Credentials and configuration data are encrypted with military-grade AES-256.

TLS 1.3 In Flight

All messages are transported across high-security encrypted TLS 1.3 tunnels.

Billing, Currency & Subscriptions

Mailcoy supports multi-currency billing (Naira ₦ for Nigerian businesses and USD $ internationally) with flat team billing.

Manage payment cards, upgrade seat tiers, and download itemized PDF VAT invoices in Settings → Billing.

Workspace & Team Admins

Customize your workspace profile, default company timezone, and invite team administrators:

Invite co-founders, IT administrators, or managers under Settings → Team Admins & Members to grant dashboard management access with role-based permissions.

Frequently Asked Questions

Yes, absolutely. Mailcoy is built from the ground up to support organizations of any size—from single-person consultancies to multi-national enterprises with hundreds of staff. With high-throughput Anycast edge MX relays, dedicated IP warming pools, multi-domain routing, SAML SSO, and centralized RBAC offboarding controls, Mailcoy easily scales to handle millions of monthly emails.

Need Instant Help or Account Diagnostics?

Click the AI Support button in the bottom right corner of your screen anytime to ask technical questions, debug DNS verification, or calculate pricing in real time.

Prefer human assistance? Email support@mailcoy.comResponse time: ~2 hours

Currently reading: Quickstart Guide