- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Directly inserts a message into only this user's mailbox similar to IMAP APPEND
, bypassing most scanning and classification. Does not send a message.
HTTP request
- Upload URI, for media upload requests:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages
- Metadata URI, for metadata-only requests:
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
userId |
The user's email address. The special value |
Query parameters
Parameters | |
---|---|
internalDateSource |
Source for Gmail's internal date of the message. |
deleted |
Mark the email as permanently deleted (not TRASH) and only visible in Google Vault to a Vault administrator. Only used for Google Workspace accounts. |
Request body
The request body contains an instance of Message
.
Response body
If successful, the response body contains an instance of Message
.
Authorization scopes
Requires one of the following OAuth scopes:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.insert
For more information, see the Authorization guide.