# gmail

Send email through a connected Google account.

Mirrors the Outlook send contract. Gmail always stores sent mail in SENT, so there is no `save_to_sent_items` option. Read endpoints (list/get/attachments) are not available: Sheetgo's Google grant carries only the `gmail.send` scope.

Base URL: `https://dev-api.sheetgo.com`. Paths are complete, version included (`/rest/beta/...`): append them to the base URL exactly as shown. Start page: https://dev-api.sheetgo.com/rest/reference.md

This page documents every endpoint of the group. Request and response shapes link to model pages; fetch the model pages an endpoint links before building a body.

Guide: [Rate Limiting](https://dev-api.sheetgo.com/rest/guides/rate-limiting.md)

Every endpoint is rate limited; see the guide [Rate Limiting](https://dev-api.sheetgo.com/rest/guides/rate-limiting.md).

<a id="post-rest-beta-gmail-send"></a>
## POST /rest/beta/gmail/send

**Send**

Send a message through the connected Google account.

Gmail always stores the sent message in SENT — there is no
``save_to_sent_items`` equivalent. Total attachment bytes are capped at 3 MB
and recipients at 50, matching the Outlook contract.

Authentication, any one of: `default`; `Developer Access`; `sheetgo-api-key`.

**Request body**

Content type `application/json`. Required.

Body: [GmailSendBody](https://dev-api.sheetgo.com/rest/reference/models/GmailSendBody.md)

**Responses**

- `202` Successful Response
- `401` Auth failed
- `422` Validation Error. Schema: [HTTPValidationError](https://dev-api.sheetgo.com/rest/reference/models/HTTPValidationError.md)

Read next: [GmailSendBody](https://dev-api.sheetgo.com/rest/reference/models/GmailSendBody.md), [HTTPValidationError](https://dev-api.sheetgo.com/rest/reference/models/HTTPValidationError.md).

---

More: start page https://dev-api.sheetgo.com/rest/reference.md, everything in one file https://dev-api.sheetgo.com/rest/llms-full.txt, OpenAPI https://dev-api.sheetgo.com/rest/openapi.json.