Gmail Connector

Access the Gmail API through OAuth. Read, send, and manage emails and labels.

Pricing

Operation	Price
Successful API call (2xx)	$0.001
Failed call (4xx/5xx)	Free

Quick Test (curl)

# List messages
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gmail", "endpoint": "/gmail/v1/users/me/messages", "method": "GET", "params": {"maxResults": 5}}'

# Get profile
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gmail", "endpoint": "/gmail/v1/users/me/profile", "method": "GET"}'

# List labels
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gmail", "endpoint": "/gmail/v1/users/me/labels", "method": "GET"}'

Request Format

POST /v1/run
{
  "model": "gmail",
  "endpoint": "/gmail/v1/users/me/messages",
  "method": "GET",
  "params": {},
  "headers": {},
  "body": {},
  "retries": 0
}

Common Endpoints

Method	Endpoint	Description
GET	/gmail/v1/users/me/messages	List messages
GET	/gmail/v1/users/me/messages/{id}	Get a message
POST	/gmail/v1/users/me/messages/send	Send a message
GET	/gmail/v1/users/me/labels	List labels

📖 Full API reference: Gmail API Docs

Technical Specs

Spec	Value
Auth	OAuth 2.0 (user-level)
Proxy	Nango (auto token refresh)
Execution	Sync
Rate limit	Inherits Gmail's API limits