Account

Requires authentication with a full-access API key. Scoped (mailbox-restricted) keys receive 403.

{
  "account": {
    "id": "clx1a2b3c0000abcd1234efgh",
    "email": "you@example.com",
    "emailVerified": true,
    "slug": "myagent",
    "plan": "free",
    "billingPeriod": "monthly",
    "suspended": false,
    "suspendedReason": null,
    "storageUsedBytes": 524288,
    "storageLimitBytes": 1073741824,
    "mailboxCount": 1,
    "activeMailboxCount": 1,
    "sentToday": 12,
    "sentThisMonth": 240,
    "receivedToday": 5,
    "bouncedToday": 0,
    "monthlyInboundCount": 42,
    "monthlyInboundLimit": 100,
    "monthlyInboundPercentage": 42,
    "monthlyInboundResetAt": "2026-05-01T00:00:00.000Z",
    "overLimitMessageCount": 0,
    "billingLinked": false,
    "annualAvailability": { "developer": true, "growth": true, "scale": true }
  }
}

billingPeriod is monthly or annual. billingLinked is true once a Stripe customer is attached to the account. annualAvailability reports which paid tiers currently offer annual billing.

Permanently delete your account and all associated data. Requires full-access authentication (unscoped API key or dashboard session). You must include a confirmation body to prevent accidental deletion.

curl -X DELETE https://api.robotomail.com/v1/account \
  -H "Authorization: Bearer $ROBOTOMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"confirm": "DELETE"}'

{ "deleted": true }

This permanently deletes all account data from the database (mailboxes, messages, attachments, domains, webhooks, API keys). External service cleanup (R2 storage, Resend domains, Stalwart accounts, Stripe subscription) is performed best-effort after the database deletion.

Errors

• 400 — Missing or invalid confirmation body
• 401 — Not authenticated
• 403 — Scoped API key (requires unscoped key or session)

Submit a support request. Requires a full-access API key. The message is emailed to the Robotomail support team with your account details attached.

{ "ok": true }

Errors

• 400 — Invalid input or invalid JSON body
• 401 — Not authenticated
• 403 — Scoped API key (full access required)
• 500 — Failed to send the support message