​

Quota System

​

How Quotas Work

• Forms - Maximum number of active forms you can create
• Submissions - Maximum form submissions per month
• Campaigns - Number of email campaigns per month (Standard & Professional only)
• Recipients - Maximum recipients per campaign (Standard & Professional only)

​

Quota Limits by Plan

​

Starter (FREE)

​

Standard

​

Professional (PRO)

​

Reset Schedule

​

Monthly Reset

• ✅ Submission count - Returns to 0
• ✅ Campaign count - Returns to 0 (Standard & Professional only)
• ✅ Email metrics - Sent, opened, and clicked counts reset to 0

• ❌ Form count - Carries over (active forms remain)
• ❌ Historical data - All submissions and analytics are preserved
• ❌ User settings - Your configurations persist
• ❌ Plan status - Your subscription continues

​

Reset Calculation

// Example: If today is March 15, 2026
const today = new Date('2026-03-15');
const nextReset = addMonths(startOfMonth(today), 1);
// Result: April 1, 2026 00:00 UTC

​

End-of-Month Warnings

​

Warning Schedule

• Users with active submissions in the current month
• Users who have used >10% of their monthly quota
• All plan types (FREE, STANDARD, PRO)

• Users with no submissions this month
• Users with less than 10% quota usage (to prevent spam)
• Users without valid email addresses

​

Warning Email Content

• Current usage statistics - How many submissions you’ve used
• Days until reset - Countdown to quota refresh
• Usage percentage - Visual representation of quota usage
• Remaining submissions - How many submissions you have left
• Action recommendations - Suggestions based on your usage
• Dashboard link - Quick access to export data or upgrade

⚠️ Your monthly quota resets in 3 days - Export your data now!

​

Why You Receive Warnings

1. Export Data - Reminder to download submissions before the month ends
2. Review Analytics - Check your current month’s performance
3. Plan Upgrade - Consider upgrading if you’re consistently near limits
4. No Surprises - Know when your quota refreshes

​

Database Schema

model Quota {
  id              String   @id @default(cuid())
  userId          String
  year            Int      // Current year
  month           Int      // Current month (1-12)
  submissionCount Int      @default(0)
  formCount       Int      @default(0)
  campaignCount   Int      @default(0)
  emailsSent      Int      @default(0)
  emailsOpened    Int      @default(0)
  emailsClicked   Int      @default(0)
  updatedAt       DateTime @updatedAt
  user            User     @relation(fields: [userId], references: [id])

  @@unique([userId, year, month])
  @@index([userId])
  @@index([year, month])
}

​

Checking Your Usage

​

From the Dashboard

1. Log in to your Mantlz dashboard
2. Navigate to Settings > Usage
3. View your current quota usage:
   • Forms created vs. limit
   • Submissions used vs. limit
   • Campaigns sent vs. limit
   • Days until quota reset

​

Via API

// Example API call to check usage
const response = await fetch('/api/usage', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const usage = await response.json();
console.log(usage);

// Response:
{
  "submissionCount": 150,
  "submissionLimit": 200,
  "formCount": 1,
  "formLimit": 1,
  "campaignCount": 0,
  "campaignLimit": 0,
  "resetDate": "2026-04-01T00:00:00.000Z",
  "daysUntilReset": 3
}

​

What Happens When You Hit Limits

​

Submission Limit Reached

• New form submissions are rejected
• API returns 429 Too Many Requests error
• Form displays “quota exceeded” message to users
• Existing submissions remain accessible

1. Wait for monthly quota reset
2. Upgrade to a higher plan for immediate increase
3. Delete old forms to reduce load (won’t help with submission limit)

​

Form Limit Reached

• Cannot create new forms
• Dashboard shows “form limit reached” message
• API returns error on form creation attempts
• Existing forms continue working normally

1. Delete an unused form to free up space
2. Upgrade to a plan with more form slots
3. Archive forms you don’t need active

​

Campaign Limit Reached

• Cannot create new campaigns this month
• Scheduled campaigns continue to run
• Draft campaigns can be saved but not sent

1. Wait for monthly quota reset
2. Upgrade to Professional for more campaigns
3. Prioritize which campaigns to send this month

​

Best Practices

​

Monitor Usage Regularly

• Check your dashboard weekly if running active campaigns
• Set up alerts when reaching 80% of any quota
• Export data regularly, not just before month-end

​

Optimize Submissions

• Use form validation to prevent spam submissions
• Implement honeypot fields to reduce bot traffic
• Use reCAPTCHA on high-traffic forms
• Monitor submission sources for anomalies

​

Plan Ahead

• Review historical usage to predict future needs
• Upgrade before hitting limits on important campaigns
• Schedule campaigns early in the month when quota is fresh
• Keep a buffer for unexpected traffic spikes

​

Data Management

• Export submissions monthly for backup
• Archive completed campaigns to reduce database size
• Delete test submissions to keep quota accurate
• Use webhooks to process data in real-time

​

Quota Management Tools

​

QuotaService Methods

// Get current month's quota
const quota = await QuotaService.getCurrentQuota(userId);

// Check if user can submit form
const canSubmit = await QuotaService.canSubmitForm(userId);

// Check if user can create form
const canCreate = await QuotaService.canCreateForm(userId);

// Update quota after submission
await QuotaService.updateQuota(userId, { submissionCount: 1 });

// Simulate end-of-month (testing only)
await QuotaService.simulateEndOfMonth();

​

Cron Jobs

​

Frequently Asked Questions

​

Need Higher Limits?

1. Upgrade to the next tier - Immediate quota increase
2. Contact sales for enterprise - Custom limits for high-volume needs
3. Optimize your forms - Reduce spam and invalid submissions