# Limits & errors

Send caps, size limits and rate limits on Google accounts, what the connection cannot do, and the errors every Gmail, Calendar and Drive call can return.

## Sending limits

| Limit | Value |
|-------|-------|
| Sends a day, consumer Gmail | 200 per mailbox, 400 after 14 clean days |
| Sends a day, Google Workspace | 500 per mailbox, 1,000 after 14 clean days |
| Cap reset | Midnight UTC |
| Same email to many people | The same subject and body to more than 50 distinct recipients in an hour starts a cooldown: 10 minutes, doubling up to 24 hours |
| Recipients | Up to 100 each in `to`, `cc` and `bcc` |
| Attachments | Up to 20, 25 MB in total |
| Payment method | Required on the workspace before the first Gmail send |

Replies count as sends. A send that Gmail rejects still uses its slot.

## Size and page limits

| Limit | Value |
|-------|-------|
| Email list page | Up to 200, default 50 |
| Labels in one update | Up to 20 in `addLabels` and 20 in `removeLabels` |
| Draft list page | Up to 100, default 25 |
| Calendar event page | Up to 200, default 50 |
| File list page | Up to 100, default 50 |
| File upload by URL | 100 MB, https, no redirects, 20 seconds |
| File upload as multipart | 4.5 MB request |
| Free-busy and availability | Up to 10 mailboxes per request |
| Picker session | 30 minutes, single-use, up to 50 preselected files |

## Rate limits

Reads are live calls to Google and are not metered. They count against your [API rate limit](/guides/rate-limits) and against the mailbox's Gmail quota of 6,000 units a minute.

| Read | Gmail units |
|---|---|
| `GET /v1/email/messages` | 5, plus 20 per message returned |
| `GET /v1/email/threads` | 10, plus 40 per thread returned |
| `GET /v1/email/threads/{threadId}` | 120 |

A full 200-thread page alone is more than the minute allows, so keep `limit` at 50 or less when you poll.

Zernio paces list and thread reads on each mailbox against one shared budget of 4,500 units a minute, and keeps the rest for incoming mail and sends.

Reading incoming mail draws on the same budget, so a busy mailbox slows your reads first.

When a read would wait more than 15 seconds for quota, it answers `429` `rate_limited` with `Retry-After` and `details.source: "zernio"`. When Google itself throttles, Zernio waits and retries once, then answers `429` with `details.source: "provider"`.

## What you cannot do

- Post or schedule social content on a Google account: use the email, calendar and files endpoints.
- Schedule an email more than 30 days ahead.
- Send from an address that is not a verified Gmail send-as alias of the mailbox.
- Open Drive files the user did not pick or Zernio did not create. Use a [picker session](/platforms/google/files#let-the-user-pick-drive-files).
- Write contacts back to Google: the sync is read-only.
- Remove one area from an account. Disconnect it and connect again with the areas you want.

## Common errors

| Error | Cause | Fix |
|-------|-------|-----|
| `400` `invalid_field_value` | A field is invalid, `scopes` is missing on connect, or `teams` conferencing on Google | Fix the field named in `param`. |
| `400` `platform_not_supported` | The account is not a Google or Microsoft account | Use the `accountId` of a mailbox. |
| `401` `reconnect_required` | Google refused the account's access | Reconnect the account. |
| `409` `account_reconnect_required` | The account was disconnected after Google refused its access. `details.reconnectPath` starts the sign-in again | Send the user through `details.reconnectPath`, or the `reconnectUrl` of `account.disconnected`. |
| `402` `payment_required` | Gmail send without a payment method on the workspace | Add a card, then send again. |
| `404` `resource_not_found` | The message, event or file does not exist, or `reason: "file_not_granted"` on Drive | Check the id, or let the user pick the file. |
| `412` `account_scope_missing` | The account lacks the area this call needs. `details` has `grantedAreas` and `missingArea` | Connect again with the area added. |
| `429` `email_send_cap_reached` | Today's send cap is used up | Wait for `resetsAt`. |
| `429` `rate_limited` | A sending cooldown, or Google throttling | Wait for `Retry-After`. |
| `502` `platform_api_error` | Google returned an error Zernio does not map | Retry. The message carries Google's. |

## Related

- [Connect](/platforms/google/connect)
- [Email](/platforms/google/email)
- [Error handling](/guides/error-handling)