Usage Limits

MoMail enforces usage limits to ensure platform stability and fair resource allocation. This guide explains how limits work and what happens when you reach them.

Limit Types

Hard Limits

Hard limits cannot be exceeded. Requests beyond these limits are rejected.

Limit Type	Free	Pro	Enterprise
Emails per month	100	10,000	Unlimited
API requests/minute	20	100	500
MCP requests/minute	10	60	300
Max email size	10 MB	25 MB	50 MB
Max attachment size	10 MB	25 MB	50 MB

Soft Limits

Soft limits trigger warnings but do not block functionality.

Limit Type	Free	Pro	Enterprise
Storage warning at	800 MB	40 GB	80% of quota
Daily email warning at	80 emails	8,000 emails	N/A
Search usage warning at	80 searches	4,000 searches	N/A

Monitoring Your Usage

Dashboard

View real-time usage in your dashboard:

Go to Settings > Usage
See current period statistics
View historical usage graphs

API

Query your usage programmatically:

curl https://api.momail.io/v1/billing/usage \
  -H "X-API-Key: your_key"

Response:

{
  "success": true,
  "data": {
    "emailsUsed": 4500,
    "emailsLimit": 10000,
    "searchesUsed": 890,
    "searchesLimit": 5000,
    "storageUsed": 256000000,
    "storageLimit": 50000000000
  }
}

Webhook Notifications

Configure webhooks to receive usage alerts:

{
  "event": "usage.warning",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "data": {
    "type": "email_quota",
    "used": 8000,
    "limit": 10000,
    "percentage": 80
  }
}

What Happens When Limits Are Reached

Email Limits

Action	Free (100/month)	Pro (10,000/month)
At 80% usage	Warning email	Dashboard notification
At 100% usage	Emails bounced	Additional emails queued for purchase

When you hit your email limit:

Incoming emails are rejected with a bounce message
You receive a notification
Upgrade or wait for the next billing period

API Rate Limits

When you exceed rate limits:

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Please try again later.",
    "details": {
      "limit": 100,
      "window": "minute",
      "retry_after": 45
    }
  }
}

Response headers include:

Retry-After: 45
X-RateLimit-Reset: 1704067200

Storage Limits

When storage is full:

New emails are still accepted
Oldest emails are automatically deleted
You receive a warning 7 days before deletion

Increasing Your Limits

Upgrade Your Plan

Upgrade anytime from your dashboard:

Go to Settings > Billing
Click Change Plan
Select your new plan
Confirm payment

Upgrades take effect immediately.

Purchase Add-ons (Pro only)

Pro users can purchase additional resources:

Add-on	Price	Description
Email pack	$5	1,000 additional emails
Storage pack	$10	10 GB additional storage
Search pack	$5	1,000 additional searches

Contact Sales (Enterprise)

For custom limits:

Email: sales@momail.io
Request custom quotas
Negotiate pricing
Set up custom alerts

Usage Optimization Tips

Reduce API Calls

Batch operations: Combine multiple requests
Use webhooks: Get notified instead of polling
Cache results: Store frequently accessed data
Optimize search: Narrow queries to reduce results

Manage Storage

Delete old emails: Use the API to clean up
Compress attachments: Reduce file sizes before sending
Use retention policies: Auto-delete after a period
Download and archive: Keep local copies of important emails

Monitor Trends

Track your usage patterns:

// Weekly usage report
async function getWeeklyUsage() {
  const usage = await fetch('/v1/billing/usage', {
    headers: { 'X-API-Key': key }
  }).then(r => r.json());

  const percentage = (usage.data.emailsUsed / usage.data.emailsLimit) * 100;

  if (percentage > 75) {
    console.warn(`Usage at ${percentage}%. Consider upgrading.`);
  }
}

Fair Use Policy

MoMail’s unlimited plans are subject to fair use:

Enterprise emails: Designed for normal business use
Abuse detection: Automated monitoring for unusual patterns
Review process: Accounts may be reviewed if usage is excessive
Contact required: We’ll reach out before taking action

Questions?

If you have questions about your limits: