Limits
Free-tier quotas, unclaimed-endpoint caps, per-IP rate limits.
- 10 endpoint creations per IP per hour. Bulk-creation agents should throttle; 429s are returned once the hour-window cap trips.
- 50 submissions lifetime per unclaimed endpoint. Spam submissions (caught by the
_gotchahoneypot) do not count toward the cap. - 30 days of no submissions → endpoint expires automatically. Unclaimed endpoints idle out.
- 2-second minimum between creations from the same IP. Prevents accidental tight loops.
- Single recipient only at creation. Fan-out to multiple destinations is a paid-tier feature that unlocks after claim.
When a caller claims the endpoint (first-submission email flow), the caps lift to the owner’s plan — Free plan still has its own quotas, but the unclaimed-specific 50-submission lifetime cap no longer applies.
Plan quotas
| Free | Pro | |
|---|---|---|
| Form submissions | 50/month | 10,000/month |
| Queue messages | 100/month | 10,000/month |
| Telemetry events | 5,000/month | 100,000/month |
| Submission retention | 30 days | 90 days |
| Telemetry retention | 7 days | 30 days |
Submission quotas are counted per endpoint, not per account.
Telemetry events are metered on a counter of their own. Events on a telemetry endpoint never count toward submissions_per_month, and form submissions never count toward the telemetry allowance — so a busy click stream cannot starve the quota that gates your lead delivery.
Dry-run requests (?dry_run=1) and claim-status probes are free on every tier and never count toward any quota.
# 10 creations per IP per hour · 2-second minimum between creations. curl -X POST https://api.gopigeon.dev/new -d 'recipient=me+test@gopigeon.dev'